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C» Activiti 


Chinese translation of the Activiti 5.x User Guide . The current version of Activiti is 5.18.0(31 July 2015). This is a GitBook 
version of the book: http://waylau.gitbooks.io/activiti-5-x-user-guide/. Let's go! 


《Activiti 5.x 用 户 指南 》 中 文 翻译 。 至 今 为 止 ，Activiti 的 最 新 版 本 为 5.18.0(2015-7-31)。 利 用 业余 时 间 对 此 进行 翻译 ， 并 在 
原文 的 基础 上 ， 插 入 配 图 ， 图 文 并 茂 方便 用 户 理解 。 如 有 勘误 欢迎 指正 ， 点 此 提问 。 如 有 兴趣 ， 也 可 以 参与 到 本 翻译 工作 中 
来 :) 另外 有 GitBook 的 版 本 方便 阅读 http://waylau.gitbooks.io/activiti-5-x-user-guide/ 
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Chapter 1. Introduction 介绍 


License 协议 


Activiti 基于 Apache V2 协议 .。Activiti Modeler 使 用 了 不 同 的 协议 LGPL 2.1 


Download 下 载 


http://activiti.org/download.html 


Sources 源码 


发 布 包 里 包含 大 部 分 的 已 经 打 好 jar 包 的 源码 。 如 果 想 找到 并 构建 完整 的 源码 库 ， 请 参考 wiki 构建 发 布 包 
Required software 需要 的 软件 


JDK 6+ 





JDK 需要 6 或 者 以 上 的 版 本 。 在 Oracle Java SE 下 载 页 面 进行 下 载 ， 安 装 完成 后 执行 java -version 命令 行 来 检验 是 否 
成 功 。 


Eclipse Indigo and Juno 


下 载 eclipse 进行 安装 ， 版 本 选 Indigo 或 者 Juno。 详 见 Chapter 12. Eclipse Designer- 安 装 一 节 
Reporting problems 报告 问题 


任何 一 个 自觉 的 开发 者 都 应 该 看 看 如 何 聪明 的 提出 问题 。 看 完 之 后 ， 你 可 以 在 用 户 论坛 上 进行 提问 和 评论 ， 或 者 在 JIRA 问 
题 跟 踪 系 统 中 创建 问题 。 


i 


壮 尽 


虽然 Activiti 已 经 托管 在 GitHub 上 了 ， 但 是 问题 不 应 该 提交 到 GitHub 的 问题 跟踪 系统 上 。 如 果 你 想 报 告 一 个 问题 ， 不 要 创 
建 一 个 GitHub 的 问题 ， 而 是 应 该 使 用 JIRA 问 题 跟 踪 系 统 





译 者 注 : 如 果 对 本 翻译 有 疑问 ， 可 以 在 https://github.com/waylau/activiti-5.x-user-guide/issues 提问 。 


Experimental features 试验 性 功能 


标记 为 [EXPERIMENTAL] 的 章节 表示 功能 尚未 稳定 。 


所 有 包 名 中 包含 .impl. 的 类 都 是 内 部 实现 类 ， 都 是 不 保证 稳定 的 。 不 过 ， 如 果 用 户 指南 把 哪些 类 列 为 配置 项 ， 那 么 它们 可 以 
认为 是 稳定 的 。 


Internal implementation classes 内 部 实现 类 


Chapter 1. Introduction 介绍 6 
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在 jar 包 中 ， 所 有 包 名 中 包含 .jmpl. (比如 : org.activiti.engine.impl.pvm.delegate) 的 类 都 是 实 现 类 ， 它们 应 该 被 视 为 流程 
引擎 内 部 的 类 。 对 于 这 些 类 和 接口 都 不 能 够 保证 其 稳定 性 。 


Chapter 1. Introduction 介绍 
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One minute version 一 分 钟 版 


从 Activiti 网 站 下 载 Activiti Explorer 的 WAR 文件 后 ， 可 以 按照 下 列 步骤 以 默认 配置 运行 示例 。 你 需要 安装 Java 运行 时 和 
Apache Tomcat (其 实 ， 任 何 提供 了 servlet 功能 的 web 容器 都 可 以 正常 运行 。 但 是 我 们 主要 是 使 用 Tomcat 进行 的 测试 ) 。 


e 把 下 载 的 activiti-explorer.war 复制 到 Tomcat 的 webapps 目录 下 。 

e 执行 Tomcat 的 bin 目录 下 的 startup.bat 或 startup.sh 启动 服务 器 。 

e。 Tomcat 启动 后 ， 打 开 浏 览 器 访问 http://localhost:8080/activiti-explorer ( 译 者 注 : 8080 是 你 的 Tomcat 安装 默认 端口 ， 
当然 你 可 以 给 Tomcat 指定 其 他 端口 号 ) 。 使 用 kermit/kermit 账号 登录 。 


这 样 就 好 了 ! Activiti Explorer 默认 使 用 H2 内 存 数据 库 ， 如 果 你 想 使 用 其 他 数据 库 请 参考 这 里 长 版 本 -Activiti setup。 


One minute version 一 分 钟 版 
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Activiti setup 安装 


要 安装 Activiti， 需要 安装 Java 运行 时 和 Apache Tomcat 同 时 确保 系统 变量 JAVA_HOME 设置 正确 。 具 体 方法 看 你 是 什么 
操作 系统 。 


只 需要 将 WAR 拷贝 进 Tomcat 的 webapps 就 能 运行 Activiti Explorer 和 REST 应 用 。 默 认 ， 应 用 是 运行 在 内 存 数据 库 的 ， 
已 经 包含 了 示例 流程 ， 用 户 和 和 群 组 信息 /区 o 


下 面 是 示例 中 可 以 使 用 的 用 户 : 


Table 2.1. The demo users 


用 户 1d 密码 角色 
kermit kermit admin 
gonzo gonzo manager 
fozzie fozzie USer 


现在 可 以 用 上 面 的 账号 访问 应 用 


Table 2.2. The webapp tools 


应 和 URL 描述 
Activiti http://localhost:8080/activiti- 用 户 控 制 台 。 使 用 此 工具 来 启 动 新 的 流程， 分 配 任务 ， 查 看 和 认领 
Explorer explorer 任务 等 ， 这 个 工具 还 允许 对 Activiti 引擎 进行 管理 。 


注意 Activiti Explorer 演示 实例 只 是 一 种 简单 快速 展示 Activiti 的 功能 的 方式 。 但 是 并 不 是 说 只 能 使 用 这 种 方式 使 用 Activiti。 
Activiti 只 是 一 个 jar， 可 以 内 嵌 到 任何 Java 环境 中 : swing 或 者 Tomcat, JBoss, WebSphere 等 等 。 也 可 以 把 Activiti 作为 
一 个 典型 的 单独 运行 的 BPM 服务 器 运行 。 只 要 java 可 以 做 的 ，Activiti 也 可 以 。 


Activiti setup 安装 
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Activiti database setup 数据 库 安 装 


就 像 在 一 分 钟 版 本 示例 里 说 过 的 ，Activiti Explorer 默认 使 用 H2 内 存 数 据 库 。 要 让 Activiti 使 用 独立 运行 的 H2 数据 库 或 者 其 
他 数据 库 ， 可 以 修改 Activiti Explorer web 应 用 WEB-INF/ classes 目录 下 的 db.properties。 


另外 ， 注 意 Activiti Explorer 自动 生成 了 demo 用 的 默认 用 户 和 和 群 组 ， 流 程 定 义 ， 数 据 模 型 。 要 想 禁 用 这 个 功能 ， 要 修改 
WEB-INF/classes 目录 下 的 属性 文件 。 禁用 demo 安装 ， 可 以 设置 所 有 属性 为 false 。 从 代码 中 也 可 以 看 出 ， 我 们 可 以 单独 
启用 或 禁用 每 一 项 功能 。 





# demo data properties 
create ,demo.users=true 
create .demo.definitions=true 
create .demo.models=true 
create.demo.reports=true 
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Include the Activiti jar and its dependencies 包含 jar 和 依赖 


想 要 包含 jar 和 依赖 ， 建 议 使 用 Maven (或 者 Ivy) 来 简化 依赖 管理 。http://www.activiti.org/community.html#maven.repository 
中 包含 了 需要 的 jar 


如 果 不 想 用 Maven， 你 也 可 以 自己 把 这 些 jar 引入 到 你 的 项 目 中 。Activiti 下 载 zip 包 包 含 了 一 个 libs 目录 ， 包 含 了 所 有 
Activiti 的 jar 包 (和 源 代码 jar 包 ) 。 依 赖 没有 用 这 种 方式 发 布 。 Activiti 引擎 必须 的 依赖 如 下 所 示 (通过 mvn 
dependency:tree 生 成 ) 


org.activiti:activiti-engine:jar:5.17.0 

+- org.activiti:activiti-bpmn-converter:jar:5.17.0:compile 

| \- org.activiti:activiti-bpmn-model:jar:5.17.0:compile 

| +- com.fasterxml.jackson.core:jackson-core:jar:2.2.3:compile 

| \- com.fasterxml.jackson.core:jackson-databind:jar:2.2.3:compile 
| \- com.fasterxml.jackson.core:jackson-annotations:jar:2.2.3:compile 
+- org.activiti:activiti-process-validation:jar:5.17.0:compile 

+- org.activiti:activiti-image-generator:jar:5.17.0:compile 

+- org.apache.commons:commons-email:jar:1.2:compile 

| +- javax.mail:mail:jar:1.4.1:compile 

| \- javax.activation:activation:jar:1.1:compile 

+- org.apache.commons:commons-lang3:jar:3.3.2:compile 

+- org.mybatis:mybatis:jar:3.2.5:compile 

+- org.springframework:spring-beans:jar:4.0.6.RELEASE:compile 

| \- org.springframework:spring-core:jar:4.0.6.RELEASE:compile 

+- joda-time:joda-time:jar:2.6:compile 

+- Org.slf4j:slf4j-api:jar:1.7.6:compile 

+- org.slf4j:jcl-over-slf4j:jar:1.7.6:compile 


注意 : 只 有 使 用 了 mail service task 才 必 须 引 入 mail 依赖 jar。 


在 Activiti 源 代码 执行 mvn dependency:copy-dependencie 依赖 将 会 轻松 下 载 
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Next steps 下 步 


使 用 Activiti Explorer web 应 用 是 一 个 熟悉 Activiti 概念 和 功能 的 好 办 法 。 但 是 ，Activiti 的 主要 目标 是 为 你 自己 的 应 用 添加 强 
大 的 BPM 和 工作 流 功 能 。 下 面 的 章节 会 帮助 你 熟悉 如 何在 你 的 环境 中 使 用 Activiti 进行 编程 : 


e。 Chapter 3. Configuration 配置 会 教 你 如 何 设置 Activiti， 如 何 获 得 ProcessEngine 类 的 实例 ， 它 是 所 有 Activiti 引擎 功 
能 的 中 心 入 口 。 

e Chapter 4. The Activiti API 会 带领 你 了 解 建立 Activiti API 的 服务 。 这 些 服务 用 简便 的 方法 提供 了 Activiti 引擎 的 强大 功 
能 ， 它 们 可 以 使 用 在 任何 Java 环境 下 。 

e 对 深入 了 解 BPMN 2.0，Activiti 引擎 中 流程 的 编写 结构 感 兴趣 吗 ? 请 继续 浏览 Chapter 7. BPMN 2.0 Introduction 介绍 
BPMN 2.0 


Next steps 下 步 12 
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Creating a ProcessEngine 创建 ProcessEngine 


Activiti 流程 引擎 的 配置 文件 是 名 为 activiti.cfg.xml 文件 。 注意 这 与 使 用 Spring 方式 创建 流程 引擎 是 不 一 样 的 。 


[= 时 3 


获得 ProcessEngine 最 简单 的 办 法 是 使 用 org.activiti.engine.ProcessEngines 类 
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine() 


它 会 在 classpath 下 搜索 activiti.cfg.xml， 并 基于 这 个 文件 中 的 配置 构建 引擎 。 下 面 代码 展示 了 实例 配置 。 后 面 的 章节 会 给 
出 配置 参数 的 详细 介绍 。 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/str 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 


<property name="jdbcUrl" value="jdbc:h2:mem:activiti;,DB CLOSE DELAY=1000" /> 
<property name="jdbcDriver" value="org.h2.Driver" /> 

<property name="jdbcUsername" value="sa" /> 

<property name="jdbcPassword" value="" /> 


<property name="databaseschemaUpdate" value="true" /> 
<property name="jobExecutorActivate" value="false" /> 


<property name="asyncExecutorEnabled" value="true" /> 
<property name="asyncExecutorActivate" value="false" /> 





<property name="mailServerHost" value="mail.my-corp.com" /> 
<property name="mailServerPort" value="5025" /> 
</bean> 


</beans> 
Es 


注意 配置 XML 文件 其 实 是 一 个 Spring 的 配置 文件 。 但 不 是 说 Activiti 只 能 用 在 Spring 环境 中 ! 我 们 只 是 利用 了 Spring 
的 解析 和 依赖 注入 功能 来 构建 引擎 。 





置 文件 中 使 用 的 ProcessEngineConfiguration 可 以 通过 编程 方式 创建 。 可 以 使 用 不 同 的 bean id 〈 比 如， 例子 第 三 行 ) 。 


ProcessEngineConfiguration.createProcessEngineConfigurationFromResourceDefault(); 
ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource); 
ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource, String beanName); 
ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(InputStream inputStream); 
ProcessEngineconfiguration.createProcessEngineconfigurationFromInputStream(InputStream inputStream, String beanName); 


二 == 玫 于 二 
也 可 以 不 使 用 配置 文件 ， 基 于 默认 创建 配置 (参考 各 种 支持 类 ) 


ProcessEngineConfiguration.createSstandaloneProcessEngineConfiguration(); 
ProcessEngineConfiguration.createSstandaloneInMemProcessEngineConfiguration(); 


所 有 这 些 ProcessEngineConfiguration.createXXX() 方法 都 返回 ProcessEngineConfiguration， 后 续 可 以 调整 成 所 需 的 对 
象 。 在 调用 buildProcessEngine() 后 ， 就 会 创建 一 个 ProcessEngine : 
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ProcessEngine processEngine = ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration() 
.SetDatabaseschemaUpdate(ProcessEngineConfiguration.DB_SCHEMA UPDATE_FALSE) 
.SetJdbcUr1l("jdbc:h2:mem:my-own-db;DB_CLOSE_DELAY=1000") 

.SetAsyncExecutorEnabled(true) 
.SetAsyncExecutorActivate(false) 
.buildProcessEngine(); 
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ProcessEngineConfiguration bean 


activiti.cfg.xml 必须 包含 一 个 bean, id 为 "processEngineConfiguration'。 
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 


这 个 bean 会 用 来 构建 ProcessEngine。 有 多 个 类 可 以 用 来 定义 processEngineConfiguration。 这 些 类 对 应 不 同 的 环境 ， 并 
设置 了 对 应 的 默认 值 。 最 好 选择 〈 最 ) 适用 于 你 的 环境 的 类 ， 这 样 可 以 少 配置 几 个 引擎 的 参数 。 下 面 是 目前 可 以 使 用 的 类 
(以 后 会 包含 更 多 ) 


e org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration: 单独 运行 的 流程 引擎 。Activiti 会 自己 处 理事 务 。 
默认 ， 数 据 库 只 在 引擎 启动 时 检测 (如 果 没 有 Activiti 的 表 或 者 表 结 构 不 正确 就 会 抛 出 异常 ) 。 

e org.activiti.engine.impl.cfg.StandalonelInMemProcessEngineConfiguration: 单元 测试 时 的 辅助 类 。Activiti 会 自己 控制 事 
务 。 默认 使 用 H2 内 存 数 据 库 。 数 据 库 表 会 在 引擎 启动 时 创建 ， 关 闭 时 删除 。 使 用 它 时 ， 不 需要 其 他 配置 (除非 使 用 
job 执行 器 或 邮件 功能 ) 。 

e org.activiti.spring.SpringProcessEngineConfiguration: 在 Spring 环境 下 使 用 流程 引擎 。 参考 Chapter 5. Spring 
integration 集成 Spring。 

e org.activiti.engine.impl.cfg.JtaProcessEngineConfiguration: 单独 运行 流程 引擎 ， 并 使 用 JTA 事务 。 
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Database configuration 数据 库 配 置 


两 种 方式 配置 数据 库 给 Activiti 引擎 使 用 。 首 先是 定义 数据 库 JDBC 属性 : 


e jdbcUrl: 数据 库 的 JDBC URL 

e jdbcDriver: 数据 库 类 型 的 驱动 实现 
e。 jdbcUsername: 数据 库 连 接 用 户 名 
e jdbcPassword: 数据 库 连 接 密码 


基于 JDBC 参数 配置 的 数据 库 连 接 会 使 用 默认 的 MyBatis 连 接 池 。 下 面 的 参数 可 以 用 来 配置 连接 池 (来 自 MyBatis 参 数 ) 


e。 jdbcMaxActiveConnections: 连接 池 中 处 于 被 使 用 状态 的 连接 的 最 大 值 。 默 认为 10 

e jdbcMaxldleConnections: 连接 池 中 处 于 空闲 状态 的 连接 的 最 大 值 

e jdbcMaxCheckoutTime: 连接 被 取出 使 用 的 最 长 时 间 ， 超 过 时 间 会 被 强制 回收 。 默认 为 20000 (20 秒 ) 

e jdbcMaxWaitTime: 这 是 一 个 底层 配置 ， 让 连接 池 可 以 在 长 时 间 无 法 获得 连接 时 ， 打印 一 条 日 志 ， 并 重新 尝试 获取 一 个 
连接 。 (避免 因为 错误 配置 导致 沉默 的 操作 失败 ) 。 默认 为 20000 (20 秒 ) 。 


数据 配置 示例 : 


<property name="jdbcUr1" value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" /> 
<property name="jdbcDriver" value="org.h2.Driver" /> 

<property name="jdbcUsername" value="sa" /> 

<property name="jdbcPassword" value="" /> 


也 可 以 使 用 javax.sql.DataSource 实现 (比如 ，Apache Commons 的 DBCP) 


<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" > 

<property name="driverClassName" value="com.mysql.jdbc.Driver" /> 

<property name="url" value="jdbc:mysql://localhost:3306/activiti" /> 

<property name="username" value="activiti" /> <property name="password" value="activiti" /> <property name="default/ 
</bean> 

<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 
<property name="dataSource" ref="dataSsource" /> 


到 


注意 ，Activiti 的 发 布 包 中 没有 这 些 类 。 你 要 自己 把 对 应 的 类 (比如 ， 从 DBCP 里 ) 放 到 你 的 classpath 下 。 无 论 你 使 用 
JDBC 还 是 DataSource 的 方式 ， 都 可 以 设置 下 面 的 配置 : 





e databaseType: 一 般 不 用 设置 ， 因 为 可 以 自动 通过 数据 库 连 接 的 元 数据 获取 。 只 有 自动 检测 失败 时 才 需 要 设置 。 可 能 的 
值 有 : {h2, mysql, oracle, postgres, mssql, db2}。 如 果 没 使 用 默认 的 H2 数 据 库 就 必须 设置 这 项 。 这 个 配置 会 决定 使 用 
哪些 创建 /删除 脚本 和 查询 语句 。 参考 支持 数据 库 章 节 了 解 支持 哪些 类 型 。 

e databaseSchemaUpdate: 设置 流程 引擎 启动 和 关闭 时 如 何 义理 数据 库 表 。 

o false (默认 ) : 检查 数据 库 表 的 版 本 和 依赖 库 的 版 本 ， 如 果 版 本 不 匹配 就 抛 出 异常 。 
o true: 构建 流程 引擎 时 ， 执 行 检查 ， 如 果 需 要 就 执行 更 新 。 如 果 表 不 存在 ， 就 创建 
o create-drop: 构建 流程 引擎 时 创建 数据 库 表 ， 关闭 流程 引擎 时 删除 这 些 表 。 
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JNDI Datasource Configuration 数据 源 配置 


默认 ，Activiti 的 数据 库 配 置 会 放 在 web 应 用 的 WEB-INF/classes 目录 下 的 db.properties 文件 中 。 这 样 做 比较 繁琐 ， 因为 
要 用 户 在 每 次 发 布 时 ， 都 修改 Activiti 源码 中 的 db.properties 并 重新 编译 War 文件 ， 或 者 解压 缩 war 文件 ， 修 改 其 中 的 
db.properties。 





使 用 JNDI (Java Naming and Directory Interface - Java 命名 和 目录 接口 ) 来 获取 数据 库 连 接 ， 连接 是 由 Servlet 容器 管理 
的 ， 可 以 在 war 部 署 外 边 管理 配置 。 与 db.properties 相 比 ， 它 也 人 允许 对 连接 进行 更 多 的 配置 。 





Usage 使 用 


要 想 把 Activiti Explorer 和 Activiti Rest 应 用 从 db.properties 转换 为 使 用 JNDI 数据 库 配 置 ， 需 要 打开 原始 的 Spring 配置 文 
件 〈activiti-webapp-explorer2/src/main/webapp/WEBINF/activiti-standalone-context.xml 和 activiti-webapp- 
rest2/src/main/resources/ activiti-context.xml) ， 删除 "dbProperties" 和 "dataSource" 两 个 bean， 然 后 添加 如 下 bean : 


<bean id="dataSource" class="org.springframework.jndi.JndiobjectFactoryBean"> 
<property name="jndiName" value="java:comp/env/jdbc/activitiDB"/> 
</bean> 


接 下 来 ， 我 们 需要 添加 包含 了 默认 的 H2 配置 的 context.xml 文件 。 如 果 已 经 有 了 JNDI 配置 ， 会 覆盖 这 些 配置 。 对 Activiti 
Explorer 来 说 ， 对 应 的 配置 文件 activiti-webapp-explorer2/src/main/webapp/META-INF/context.xml 如 下 所 示 : 


<Context antiJARLocking="true" path="/activiti-explorer2"> 

<Resource auth="Container" 
name="jdbc/activitiDB" 
type="javax.sql.DataSource" 
scope="Shareable" 
description="JDBC DataSource" 
url="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" 
driverCclassName="org.h2.Driver" 
username="sa" 
password= 
defaultAutoCommit="false" 
initialSize="5" 
maxwait="5000" 
maxActive="120" 
maxIdle="5"/> 


</Context> 


对 于 Activiti REST web 应 用 ， 添 加 的 activiti-webapp-rest2/src/main/webapp/META-INF/context.xml 如 下 所 示 : 


<?xml version="1.0" encoding="UTF-8"?> 
<Context antiJARLocking="true" path="/activiti-rest2"> 
<Resource auth="Container" 

name="jdbc/activitiDB" 
type="javax.sql.DataSource" 
scope="Shareable" 
description="JDBC DataSource" 
url="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=-1" 
driverCclassName="org.h2.Driver" 
username="sa" 
password= 
defaultAutoCommit="false" 
initialSize="5" 
maxwait="5000" 
maxActive="120" 
maxIdle="5"/> 





</Context> 





JNDI Datasource Configuration 数据 源 配 置 17 














Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 








可 选 的 一 步 ， 现 在 可 以 删除 Activiti Explorer 和 Activiti REST 两 个 应 用 中 不 再 使 用 的 db.properties 文件 了 。 


Configuration 配置 


JNDI 数据 库 配 置 会 因为 你 使 用 的 Servlet 容器 不 同 而 不 同 。 下 面 的 配置 可 以 在 Tomcat 中 使 用 ， 但 是 对 其 他 容器 ， 请 引用 你 
使 用 的 容器 的 文档 。 


如 果 使 用 Tomcat，JNDI 资 源 配置 在 $CATALINA_BASE/conf[enginename]/[hostname]/[warname].xml (对 于 Activiti 
Explorer 来 说 ， 通 常 是 在 $CATALINA_BASE/conf/ Catalina/localhost/activiti-explorer.war) 。 当 应 用 第 一 次 发 布 时 ， 会 把 这 
个 文件 从 war 中 复制 出 来 。 所 以 如 果 这 个 文件 已 经 存在 了 ， 你 需要 替换 它 。 要 想 修改 JNDI 资源 让 应 用 连接 mysql 而 不 是 
H2， 可 以 像 下 面 这 样 修改 : 


<?xml version="1.0" encoding="UTF-8"?> 
<Context antiJARLocking="true" path="/activiti-explorer2"> 
<Resource auth="Container" 
name="jdbc/activitiDB" 
type="javax.sql.DataSource" 
description="JDBC DataSource" 
url="jdbc:mysql://localhost:3306/activiti" 
driverClassName="com.mysql.jdbc.Driver" 
username="sa" 
password= 
defaultAutoCommit="false" 
initialSize="5" 
maxwait="5000" 
maxActive="120" 
maxIdle="5"/> 
</Context> 
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Supported databases 支持 的 数据 库 


下 面 是 可 以 引用 的 类 型 


Table 3.1. Supported databases 


Activiti 数据 库 类 


型 JDBC URL 示 例 备注 
h2 jdbc:h2:tcp://localhost/activiti 默认 配置 数据 库 
mysql jdbc:mysql:/localhost:3306/activiti 使 用 mysql-connector-java 驱动 进行 
autoReconnect=true 测试 
oracle jdbc:oracle:thin:@localhost:1521:xe 
postgres jdbc:postgresql://localhost:5432/activiti 
db2 jdbc:db2://localhost:50000/activiti 
mssql jdbc:sqlserver:/localhost:1433/activiti 


Supported databases 支持 的 数据 库 
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Creating the database tables 创建 数据 库 表 


下 面 是 创建 数据 库 表 最 简单 的 办 法 : 


e 把 activiti-engine 的 jar 放 到 classpath 下 

e 添加 对 应 的 数据 库 驱 动 

e。 把 Activiti 配置 文件 (activiti.cfg.xml) 放 到 classpath 下 ， 指向 你 的 数据 库 (参考 数据 库 配置 章节 ) 
e 执行 DbSchemaCreate 类 的 main 方法 


不 过 ， 一 般 情 况 只 有 数据 库 管理 员 才能 执行 DDL 语句 。 在 生产 环境 ， 这 也 是 最 明智 的 选择 。SQL DDL 语 名 可 以 从 Activiti 下 
载 页 或 Activiti 发 布 目 录 里 找到 ， 在 database 子 目录 下 。 脚本 也 包含 在 引擎 的 jar 中 (activiti-engine-x.jar)， 在 
org/activiti/db/create 包 下 (drop 目录 里 是 删除 语句 ) 。 SQL 文件 的 命名 方式 如 下 





activiti.{db}.{create|ldrop}.{type}.sql 


其 中 db 是 支持 的 数据 库 ， type 是 


e engine: 引擎 执行 的 表 。 必 须 。 

e identity: 包含 用 户 ， 群 组 ， 用 户 与 组 之 间 的 关系 的 表 。 这 些 表 是 可 选 的 ， 只 有 使 用 引擎 自 带 的 默认 身份 管理 时 才 需 要 。 

e history: 包含 历史 和 审计 信息 的 表 。 可 选 的 : 历史 级 别 设 为 none 时 不 会 使 用 。 注意 这 也 会 引用 一 些 需要 把 数据 保存 到 万 
史 表 中 的 功能 (比如 任务 的 评论 ) 。 


MySQL 用 户 需 要 注意 : 版 本 低 于 5.6.4 的 MySQL 不 支持 毫秒 精度 的 timestamp 或 date 类 型 。 更 严重 的 是 ， 有 些 版 本 会 在 
尝试 创建 这 样 一 列 时 抛 出 异常 ， 而 有 些 版 本 则 不 会 。 在 执行 自动 创建 /更 新 时 ， 引 警 会 在 执行 过 程 中 修改 DDL。 当 使 用 DD 
L 时 ， 可 以 选择 通用 版 本 和 名 为 mysql55 的 文件 。 〔 它 适合 所 有 版 本 低 于 5.6.4 的 情况 ) 。 后 一 个 文件 会 将 列 的 类 型 设置 为 没 
有 毫秒 的 情况 。 


总 结 一 下 ， 对 于 MySQL 版 本 会 执行 如 下 操作 

e@ <5.6: 不 支持 毫秒 精度 。 可 以 使 用 DDL 文件 (包含 mysql55 的 文件 ) 。 可 以 实现 自动 创建 /更 新 。 

e 5.6.0 - 5.6.3: 不 支持 毫秒 精度 。 无 法 自动 创建 /更 新 。 建 议 更 新 到 新 的 数据 库 版 本 。 如 果真 的 需要 的 话 ， 也 可 以 使 用 
mysql 5.5。 

e 5.6.4+: 支 持 毫 秒 精 度 。 可 以 使 用 DDL 文 件 (默认 包含 mysq| 的 文件 ) 。 可 以 实现 自动 创建 、 更 新 。 


注意 对 于 已 经 更 新 了 MySQL 数据 库 ， 而 且 Activiti 表 已 经 创建 /更 新 的 情况 ， 必须 手工 修改 列 的 类 型 。 
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Database table names explained 理解 数据 库 表 名 字 


Activiti 的 表 都 以 ACT_ 开头。 第 二 部 分 是 表示 表 的 用 途 的 两 个 字母 标识 。 用 途 也 和 服务 的 API 对 应 。 


e ACTRE*: 'RE' 表 示 repository。 这 个 前 级 的 表 包 含 了 流程 定义 和 流程 静态 资源 (图 片 ， 规 则 ， 等 等 ) 。 

e ACTRU*: 'RU' 表 示 runtime。 这 些 运行 时 的 表 ， 包 含 流程 实例 ， 任 务 ， 变 量 ， 异 步 任 务 ， 等 运行 中 的 数据 。 Activiti 只 在 
流程 实例 执行 过 程 中 保存 这 些 数据 ， 在 流程 结束 时 就 会 删除 这 些 记 录 。 这 样 运行 时 表 可 以 一 直 很 小 速度 很 快 。 

e ACTID*: 'ID' 表 示 identity。 这 些 表 包含 身份 信息 ， 比 如 用 户 ， 组 等 等 。 

e ACTHI*: HI 表示 history。 这 些 表 包 含 万 史 数 据 ， 比 如 历史 流程 实例 ， 变量 ， 任 务 等 等 。 

e。 ACTGE*: general 数据 ， 用 于 不 同 场景 下 。 














员 
[ny 
当 
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Database upgrade 数据 库 升 级 


在 执行 更 新 之 前 要 先 各 份 数据 库 〈 使 用 数据 库 的 备份 功能 


默认 ， 每 次 构建 流程 引擎 时 都 会 进行 版 本 检测 。 这 一 切 都 在 应 用 启动 或 Activiti webapp 启动 时 发 生 。 如 果 Activiti 发 现 数据 
库 表 的 版 本 与 依赖 库 的 版 本 不 同 ， 就 会 抛 出 异常 。 


要 升级 ， 你 要 把 下 面 的 配置 放 到 activiti.cfg.xml 配置 文件 里 : 


DOA a 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 
le 
<property name="databaseschemaUpdate" value="true" /> 
Ce 

</bean> 


</beans> 


然后 ， 把 对 应 的 数据 库 驱 动 放 到 classpath 里 。 升级 应 用 的 Activiti 依 赖 。 启动 一 个 新 版 本 的 Activiti 指向 包含 旧版 本 的 数据 
库 。 将 databaseSchemaUpdate 设置 为 true， Activiti 会 自动 将 数据 库 表 升级 到 新 版 本 ， 


当 发 现 依赖 和 数据 库 表 版 本 不 通过 时 。 也 可 以 执行 更 新 升级 DDL 语句 。 也 可 以 执行 数据 库 脚 本 ， 可 以 在 Activiti 下 载 页 找 
到 。 
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Job Executor and Async Executor (since version 5.17.0) 


从 版 本 5.17.0 开始 ， 除 了 Job Executor (作业 执行 器 ) 之 外 ， Activiti 还 提供 了 一 个 Async executor (异步 执行 器 ) 。 
Async executor 在 Activiti 引擎 中 是 一 个 更 好 的 性 能 和 对 数据 库 更 友好 的 执行 异步 作业 的 方式 。 因 此 建议 切换 到 Async 
executor， 在 默认 情况 下 仍然 使 用 旧 的 job executor 。 更 多 的 信息 可 以 在 用 户 指南 的 高 级 部 分 找到 。 


Job Executor and Async Executor 
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Job executor activation 启用 Job executor 


JobExecutor 是 管理 一 系列 线程 的 组 件 ， 可 以 触发 定时 器 (也 包含 后 续 的 异步 消息 ) 。 在 单元 测试 场景 下 ， 很 难 使 用 多 线 
程 。 因 此 API 允许 查询 (ManagementService.createJobQuery) 和 执行 job (ManagementService.executeJob)， 所 以 job 可 
以 在 单元 测试 中 控制 。 要 避免 与 job 执行 器 冲突 ， 可 以 关闭 它 。 


默认 ，JobExecutor 在 流程 引擎 启动 时 就 会 激活 。 如 果 不 想 在 流程 引擎 启动 后 自动 激活 JobExecutor， 可 以 设置 


<property name="jobExecutorActivate" value="false" /> 


当 流 程 引擎 引导 时 ,不 想 激活 JobExecutor。 


Job executor activation 启用 Job executor 24 














Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 





Async executor activation 启用 Async executor 


AsyncExecutor 是 管理 线程 池 的 组 件 ， 可 以 触发 定时 器 和 异步 任务 。 


默认 ，AsyncExecutor 是 不 启用 的 ， 由 于 遗留 原因 使 用 的 是 JobExecutor。 不 过 建议 使 用 新 的 AsyncExecutor 来 代替 。 可 以 
通过 定义 两 个 属性 





<property name="asyncExecutorEnabled" value="true" /> 
<property name="asyncExecutorActivate" value="true" /> 





asyncExecutorEnabled 属性 启用 Async executor 代替 旧 的 Job executor。 第 二 个 属性 asyncExecutorActivate 指示 Activiti 
引擎 在 启动 时 启动 Async executor 线程 池 。 
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Mail server configuration 配置 邮件 服务 器 


可 以 选择 配置 邮件 服务 器 。Activiti 支持 在 业务 流程 中 发 送 邮件 。 想 真 正 的 发 送 一 个 e-mail， 必 须 配 置 一 个 真实 的 SMTP 邮 


件 服 务 器 。 参考 e-mail 任务 。 


Mtail server configuration 配置 邮件 服务 器 
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History configuration 配置 历史 
可 以 选择 定制 历史 存储 的 配置 。 你 可 以 通过 配置 影响 引擎 的 历史 功能 。 参考 History configuration 配置 这 一 节 。 


<property name="history" value="audit" /> 


History configuration 配置 历史 
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Exposing configuration beans in expressions and scripts 在 表 
达 式 和 脚本 中 暴露 配置 


默认 ，activiti.cfg.xml 和 你 自己 的 Spring 配置 文件 中 所 有 bean 都 可 以 在 表达 式 和 脚本 中 使 用 。 如 果 你 想 限 制 配置 文件 中 的 
bean 的 可 见 性 ， 可 以 配置 流程 引擎 配置 的 bean 配置 。 ProcessEngineConfiguration 的 beans 是 一 个 map。 当 你 指定 了 这 
个 参数 ， 只 有 包含 这 个 map 中 的 bean 可 以 在 表达 式 和 脚本 中 使 用 。 通过 在 map 中 指定 的 名 称 来 决定 暴露 的 bean。 
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Deployment cache configuration 配置 部 署 缓 存 


所 有 流程 定义 都 被 缓存 了 解析 之 后 ) 避免 每 次 使 用 前 都 要 访问 数据 库 ， 因为 流程 定义 数据 是 不 会 改变 的 。 默认 ， 不 会 限制 
这 个 缓存 。 如 果 想 限制 流程 定义 缓存 ， 可 以 添加 如 下 配置 


<property name="processDefinitionCacheLimit" value="10" /> 


这 个 配置 会 把 默认 的 hashmap 缓存 替换 成 LRU 缓存 ， 来 提供 限制 。 当然 ， 这 个 配置 的 最 佳 值 跟 流程 定义 的 总 数 有 关 ， 实 
际 使 用 中 会 具体 使 用 多 少 流程 定义 也 有 关 。 也 你 可 以 注入 自己 的 缓存 实现 。 这 个 bean 必须 实现 
org.activiti.engine.impl.persistence.deploy.DeploymentCache 接口 : 


<property name="processDefinitionCache"> 
<bean class="org.activiti.MyCache" /> 
</property> 


有 一 个 类 似 的 配置 叫 knowledgeBaseCacheLimit 和 knowledgeBaseCache， 它们 是 配置 规则 缓存 的 。 只 有 流程 中 使 用 规则 
任务 时 才 会 用 到 。 
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Logging 日 志 


从 Activiti 5.12 开始 ，SLF4J 被 用 作 日 志 框 架 ， 替 换 了 之 前 使 用 java.util.logging。 所 有 日 志 (activiti, spring, mybatis 等 等 ) 


都 转发 给 SLF4J 允许 使 用 你 选择 的 日 志 实 现 。 


默认 activiti-engine 依赖 中 没有 提供 SLF4J 绑 定 的 jar， 需要 根据 你 的 实际 需要 使 用 日 志 框 架 。 如 果 没有 添加 任何 实现 
jar，SLF4J 会 使 用 NOP-logger， 不 使 用 任何 日 志 ， 不 会 发 出 警告 ， 而 且 什 么 日 志 都 不 会 记录 。 可 以 通过 
http://www.slf4j.org/codes.html#StaticLoggerBinder 了 解 这 些 实现 。 使 用 Maven， 上 比如 使 用 一 个 依赖 (这 里 使 用 log4j) ， 
注意 你 还 需要 添加 一 个 version : 配置 


org.slf4j slf4j-log4j12 
activiti-explorer 和 activiti-rest 应 用 都 使 用 了 Log4j 绑 定 。 执 行 所 有 activiti-* 模块 的 单元 测试 页 使 用 了 Log4j。 


特别 提醒 如 果 容 器 classpath 中 存在 commons-logging : 为 了 把 spring 日 志 转 发 给 SLF4J， 需 要 使 用 桥接 (参考 
http://www.slf4j.org/legacy.html 胡 cIlOverSLF4J) 。 如 果 你 的 容器 提 供 了 commons-logging 实 现 ， 请 参考 下 面 网 页 : 
http://www.slf4j.org/codes.html#release 来 确保 稳定 性 。 使 用 Maven 的 实例 (忽略 版 本 ) 


<dependency> 
<groupId>org.slf4j</groupId> 
<artifactId>slf4j-10g4j12</artifactId> 
</dependency> 


activiti-explorer 和 activiti-rest 应 用 都 使 用 了 Log4j 绑 定 。 执 行 所 有 activiti-* 模块 的 单元 测试 页 使 用 了 Log4j。 


特别 提醒 如 果 容器 classpath 中 存在 commons-logging : 为 了 把 spring 日 志 转 发 给 SLF4J， 需 要 使 用 桥接 (参考 
http://www.slf4j.org/legacy.html 胡 cIlOverSLF4J) 。 如 果 你 的 容器 提供 了 commons-logging 实现 ， 请 参考 下 面 网 
页 : http://www.slf4j.org/codes.html#release 来 确保 稳定 性 。 


使 用 Maven 的 实例 (忽略 版 本 ) 


<dependency> 
<groupId>org.slf4j</groupId> 
<artifactId>jcl-over-slf4j</artifactId> 
</dependency> 
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Mapped Diagnostic Contexts 映射 诊断 上 下 文 


在 5.13 中 ，activiti 支持 slf4j 的 MDC 功能 。 如 下 的 基础 信息 会 传递 到 日 志 中 记录 : 

e 流程 定义 ld 标记 为 mdcProcessDefinitionID 

e 流程 实例 ld 标记 为 mdcProcesslnstancelD 

e@ 分 支 ld 标记 为 mdcexecutionld 
默认 不 会 记录 这 些 信 息 。 可 以 配置 日 志 使 用 期 望 的 格式 来 显示 它们 ， 扩 展 通常 的 日 志 信息 。 比 如 ， 下 面 的 log4j 配置 定义 会 
让 日 志 显 示 上 面 提 及 的 信息 : 


1og4j .appender .consoleAppender .1Layout.ConversionPattern =ProcessDefinitionId=%X{mdcProcessDefinitionID} 
executionId=%X{mdcExecutionId} mdcProcessInstanceID=%X{mdcProcessInstanceID} mdcBusinessKey=%X{mdcBusinessKey} %m%n" 


则 室 == 寺 es 守 到 


当 系 统 进 行 高 风险 任务 ， 日 志 必 须 严 格 检查 时 ， 这 个 功能 就 非常 有 用 ， 比 如 要 使 用 日 志 分 析 的 情况 。 
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Event handlers 事件 处 理 


Activiti 5.15 中 实现 了 一 种 事件 机 制 。 它 允许 在 引擎 触发 事件 时 获得 提醒 。 参考 所 有 支持 的 事件 类 型 了 解 有 效 的 事件 。 


可 以 为 对 应 的 事件 类 型 注册 监听 器 ， 在 这 个 类 型 的 任何 时 间 触发 时 都 会 收 到 提醒 。 你 可 以 添加 引擎 范围 的 事件 监听 器 通过 配 
置 ， 添加 引擎 范围 的 事件 监听 器 在 运行 阶段 使 用 API， 或 添加 event-listener 到 特定 流程 定义 的 BPMN XML 中 。 


所 有 分 发 的 事件 ， 都 是 org.activiti.engine.delegate.event.ActivitiEvent 的 子 类 。 事 件 包含 〈 如 果 有 效 ) type，executionld， 
processlnstanceld 和 processDefinitionld。 对 应 的 事件 会 包含 事件 发 生 时 对 应 上 下 文 的 额外 信息 ， 这 些 额 外 的 载荷 可 以 在 所 
有 支持 的 事件 类 型 中 找到 。 


Event listener implementation 事件 监听 实现 


实现 事件 监听 器 的 唯一 要 求 是 实现 org.activiti.engine.delegate.event.ActivitiEventListener。 西 面 是 一 个 实现 监听 器 的 例子 ， 
它 会 把 所 有 监听 到 的 事件 打印 到 标准 输出 中 ， 包 括 job 执 行 的 事件 异常 : 


public class MyEventListener implements ActivitiEventListener { 


@override 
public void onEvent(ActivitiEvent event) { 
switch (event.getType()) { 


case JOB_EXECUTION_SUCCESS : 
System.out.println("A job well done!"); 
break 


case JOB EXECUTION_FAILURE: 
System.out.println("A job has failed..."); 
break 


default: 
System.out.printin("Event received: "+ event.getType()); 
} 
3 





@override 
public boolean isFailOnException() { 
// The logic in the onEvent method of this listener is not critical, exceptions 
// can be ignored if logging fails... 
return false; 
1 
由 


isFailOnException() 方法 决定 了 当 事 件 分 发 时 ，onEvent(..) 方法 抛 出 异常 时 的 行为 。 这 里 返回 的 是 false， 会 忽略 异常 。 当 
返回 true 时 ， 异 常 不 会 忽略 ， 继 续 向 上 传播 ， 迅 速 导致 当前 命令 失败 。 当 事 件 是 一 个 API 调用 的 一 部 分 时 (或 其 他 事务 性 
操作 ， 比 如 job 执行 ) ， 事务 就 会 回 滚 。 当 事件 监听 器 中 的 行为 不 是 业务 性 时 ， 建 议 返 回 false。 activiti 提供 了 一 些 基础 的 
实现 ， 实 现 了 事件 监听 器 的 常用 场景 。 可 以 用 来 作为 基 类 或 监听 器 实现 的 样 例 : 


e org.activiti.engine.delegate.event.BaseEntityEventListener : 这 个 事件 监听 器 的 基 类 可 以 用 来 监听 实体 相关 的 事件 ， 可 
以 针对 某 一 类 型 实体 ， 也 可 以 是 全 部 实体 。 它 隐 藏 了 类 型 检测 ， 并 提供 了 三 个 需要 重 写 的 方法 : onCreate(..)， 
onUpdate(..) 和 onDelete(..)， 当 实 体 创建 ， 更 新 ， 或 删除 时 调用 。 对 于 其 他 实体 相关 的 事件 ， 会 调用 
onEntityEvent(..)。 


Configuration and setup 配置 和 安装 
把 事件 监听 器 配置 到 流程 引擎 配置 中 时 ， 会 在 流程 引擎 启动 时 激活 ， 并 在 引擎 启动 启动 中 持续 工作 着 。 


eventListeners 属性 需要 org.activiti.engine.delegate.event.ActivitiEventListener 的 队列 。 通常 ， 我 们 可 以 声明 一 个 内 部 的 
bean 定 义 ， 或 使 用 ref 引用 已 定义 的 bean。 下 面 的 代码 ， 向 配置 添加 了 一 个 事件 监听 器 ， 任 何事 件 触 发 时 都 会 提醒 它 ， 无 
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<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 


<property name="eventListeners"> 
<St> 
<bean class="org.activiti.engine.example.MyEventListener" /> 
</list> 
</property> 
</bean> 


为 了 监听 特定 类 型 的 事件 ， 可 以 使 用 typedEventListeners 属性 ， 它 需要 一 个 map 参数 。 map 的 key 是 逗号 分 隔 的 事件 名 
(或 单独 的 事件 名 ) 。 map 的 value 是 org.activiti.engine.delegate.event.ActivitiEventListener 队列 。 下 面 的 代码 演示 了 向 
配置 中 添加 一 个 事件 监听 器 ， 可 以 监听 job 执行 成 功 或 失败 : 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 


<property name="typedEventListeners"> 
<map> 
<entry key="JOB_ EXECUTION_SUCCESS, JOB_EXECUTION_FAILURE" > 
< E> 
<bean class="org.activiti.engine.example.MyJobEventListener" /> 
< TSE> 
</entry> 
</map> 
</property> 
</bean> 





分 发 事件 的 顺序 是 由 监听 器 添加 时 的 顺序 决定 的 。 首 先 ， 会 调用 所 有 普通 的 事件 监听 器 (eventListeners 属性 ) ， 按 照 它们 
在 list 中 的 次 序 。 然后 ， 会 调用 所 有 对 应 类 型 的 监听 器 ( typedEventListeners 属性 ) ， 如 果 对 应 类 型 的 事件 被 触发 了 。 


Adding listeners at runtime 运行 时 添加 监听 


可 以 通过 API (RuntimeService) 在 运行 阶段 添加 或 删除 额外 的 事件 监听 器 


i 
* Adds an event-listener which will be notified of ALL events by the dispatcher. 
* @param listenerToAdd the listener to add 
ww 

void addEventListener(ActivitiEventListener listenerToAdd); 


pi 
* Adds an event-listener which will only be notified when an event occurs, which type is in the given types. 
* @param listenerToAdd the listener to add 
* @param types types of events the listener should be notified for 
Sy 
void addEventListener(ActivitiEventListener listenerToAdd, ActivitiEventType... types); 


A** 

* Removes the given listener from this dispatcher. The listener will no longer be notified, 
* regardless of the type(s) it was registered for in the first place. 

* @param listenerToRemove listener to remove 

9 

void removeEventListener(ActivitiEventListener listenerToRemove); 


注意 运行 期 添加 的 监听 器 引擎 重启 后 就 消失 了 


Adding listeners to process definitions 添加 监听 到 流程 定义 


可 以 为 特定 流程 定义 添加 监听 器 。 监 听 器 只 会 监听 与 这 个 流程 定义 相关 的 事件 ， 以 及 这 个 流程 定义 上 发 起 的 所 有 流程 实例 的 
事件 。 监听 器 实现 可 以 使 用 ， 全 类 名 定义 ， 引 用 实现 了 监听 器 接口 的 表达 式 ， 或 配置 为 抛 出 一 个 message/signal/error 的 


Event handlers 事件 处 理 33 

















Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 


BPMN 事件 。 


Listeners executing user-defined logic 让 监听 器 执行 用 户 定 义 的 逻辑 


下 面 代码 为 一 个 流程 定义 添加 了 两 个 监听 器 。 第 一 个 监听 器 会 接收 所 有 类 型 的 事件 ， 它 是 通过 全 类 名 定义 的 。 第 二 个 监听 器 
只 接收 作业 成 功 或 失败 的 事件 ， 它 使 用 了 定义 在 流程 引擎 配置 中 的 beans 属性 中 的 一 个 bean。 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener class="org.activiti.engine.test.MyEventListener" /> 
<activiti:eventListener delegateExpression="${testEventListener}" events="JOB_ EXECUTION. SUCCESS, JOB_EXECUTION_FAILL 
</extensionElements> 


</process> 


图 El 


对 于 实体 相关 的 事件 ， 也 可 以 设置 为 针对 某 个 流程 定义 的 监听 器 ， 实 现 只 监听 发 生 在 某 个 流程 定义 上 的 某 个 类 型 实体 事件 。 
下 面 的 代码 演示 了 如 何 实现 这 种 功能 。 可 以 用 于 所 有 实体 事件 〈 第 一 个 例子 ) ， 也 可 以 只 监听 特定 类 型 的 事件 〈 第 二 个 例 
于 ) 





<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventlistener class="org.activiti.engine.test.MyEventListener" entityType="task" /> 
<activiti:eventListener delegateExpression="${testEventListener}" events="ENTITY_CREATED" entityType="task" /> 
</extensionElements> 


</process> 


entityType 支持 的 值 有 : attachment, comment, execution ,identity-link, job, process-instance, process-definition, task。 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener class="org.activiti.engine.test.MyEventListener" entityType="task" /> 
<activiti:eventListener delegateExpression="${testEventListener}" events="ENTITY_CREATED" entityType="task" /> 
</extensionElements> 


</process> 


Listeners throwing BPMN events 
[试验 阶段 ] 


另 一 种 义理 事件 的 方法 是 抛 出 一 个 BPMN 事件 。 请 注意 它 只 针对 与 抛 出 一 个 activiti 事件 类 型 的 BPMN 事件 。 比如 ， 抛 出 一 
个 BPMN 事件 ， 在 流程 实例 删除 时 ， 会 导致 一 个 错误 。 下 面 的 代码 演示 了 如 何在 流程 实例 中 抛 出 一 个 signal， 把 signal 抛 
出 到 外 部 流程 〈 全 局 ) ， 在 流程 实例 中 抛 出 一 个 消息 事件 ， 在 流程 实例 中 抛 出 一 个 错误 事件 。 除 了 使 用 class 或 
delegateExpression， 还 使 用 了 throwEvent 属性 ， 通 过 额外 属性 ， 指 定 了 抛 出 事件 的 类 型 。 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="signal" signalName="My signal" events="TASK _ASSIGNED" /> 
</extensionElements> 
</process> 
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<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="globalSignal" signalName="My signal" events="TASK ASSIGNED" /> 
</extensionElements> 
</process> 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="message" messageName="My message" events="TASK ASSIGNED" /> 
</extensionElements> 
</process> 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="error" errorCode="123" events="TASK _ASSIGNED" /> 
</extensionElements> 
</process> 


如 果 需 要 声明 额外 的 逻辑 ， 是 否 抛 出 BPMN 事件 ， 可 以 扩展 activiti 提供 的 监听 器 类 。 在 子 类 中 重 写 
isValidEvent(ActivitiEvent event)， 可 以 防止 抛 出 BPMN 事件 。 对 应 的 类 是 
org.activiti.engine.test.api.event.SignalThrowingEventListenerTest, 
org.activiti.engine.impl.bpmn.helper.MessageThrowingEventListener 和 
org.activiti.engine.impl.bpmn.helper.ErrorThrowingEventListener. 


Notes on listeners on a process-definition 流程 定义 中 监听 器 的 注意 事项 


e。 事件 监听 器 只 能 声明 在 process 元 素 中 ， 作 为 extensionElements 的 子 元 素 。 监听 器 不 能 定义 在 流程 的 单个 activity 
Fs 

e delegateExpression 中 的 表达 式 无 法 访问 execution 上 下 文 ， 这 和 与 其 他 表达 式 不 同 (比如 gateway ) 。 它 只 能 引用 定义 
在 流程 引擎 配置 的 beans 属性 中 声明 的 bean， 或 者 使 用 spring (未 使 用 beans 属性 ) 中 所 有 实现 了 监听 器 接口 的 
Spring-bean。 

e 在 使 用 监听 器 的 class 属性 时 ， 只 会 创建 一 个 实例 。 记 住 监 听 器 实现 不 会 依赖 成 员 变 量 ， 确 认 是 多 线程 安全 的 。 

e。 当 一 个 非法 的 事件 类 型 用 在 events 属性 或 throwEvent 中 时 ， 流 程 定 义 发 布 时 就 会 抛 出 异常 。 (会 导致 部 署 失 败 ) 。 如 
果 class 或 delegateExecution 由 问题 (类 不 存在 ， 不 存在 的 bean 引用 ， 或 代理 类 没有 实现 监听 器 接口 ) ， 会 在 流程 启 
动 时 抛 出 异常 (或 在 第 一 个 有 效 的 流程 定义 事件 被 监听 器 接收 时 ) 。 所 以 要 保证 引用 的 类 正确 的 放 在 classpath 下 ， 表 
达 式 也 要 引用 一 个 有 效 的 实例 。 


Dispatching events through API 通过 API 分 发 事件 


我 们 提供 了 通过 API 使 用 事件 机 制 的 方法 ， 人 允许 大 家 触发 定义 在 引擎 中 的 任何 自 定义 事件 。 建议 (不 强制 ) 只 触发 类 型 为 
CUSTOM 的 ActivitiEvents。 可 以 通过 RuntimeService 触发 事件 : 


Dispatches the given event to any listeners that are registered . 
@param event event to dispatch . 


@throws ActivitiException if an exception occurs when dispatching the event or when the {@link ActivitiEventDispatcr 
is disabled . 


类 
类 
大 
类 
大 
类 
* @throws ActivitiIllegalArgumentException when the given event is not suitable for dispatching. 


void dispatchEvent (ActivitiEvent event); 


ER 
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Supported event types 支持 的 事件 类 型 





下 面 是 引擎 中 可 能 出 现 的 所 有 事件 类 型 。 


值 


Table 1. Supported events 


Event 名 称 


ENGINE_CREATED 


ENGINE_CLOSED 


ENTITY_CREATED 


ENTITY_INITIALIZED 


ENTITY_UPDATED 


ENTITY_DELETED 


ENTITY_SUSPENDED 


ENTITY_ACTIVATED 


JOB_EXECUTION_SUCCESS 


JOB_EXECUTION FAILURE 


JOB_RETRIES_DECREMENTED 


TIMER_FIRED 


JOB_CANCELED 


ACTIVITY_STARTED 


ACTIVITY_COMPLETED 


ACTIVITY_CANCELLED 


ACTIVITY_SIGNALED 
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描述 
监听 器 监听 的 流程 引擎 已 经 创建 完毕 ， 
并 准备 好 接受 API 调 用 。 


监听 器 监听 的 流程 引擎 已 经 关 闭 ， 不 再 
接受 API 调 用 。 


创建 了 一 个 新 实体 。 实 体 包含 在 事件 


o 


创建 了 一 个 新 实体 ， 初 始 化 也 完成 了 。 
如 果 这 个 实体 的 创建 会 包含 子 实体 的 创 
建 ， 这 个 事件 会 在 子 实体 都 创建 /初始 化 
完成 后 被 触发 ， 这 是 与 
ENTITY_CREATED 的 区 

别 。 ENTITY_CREATE event. 


更 新 了 已 存在 的 实体 。 实 体 包含 在 事件 


o 


ee 已 存在 的 实体 。 实 体 包含 在 事件 


RA 实体 包含 在 事件 


ProcessDefinitions,Processlnstances 


和 Tasks 抛 出 。 
激活 了 已 存在 的 实体 ， 实 体 包含 在 事件 


中 。 会 被 ProcessDefinitions， 
Processlnstances 和 Tasks 抛 出 。 


作业 执行 成 功 。job 包 含 在 事件 中 。 


作业 执行 失败 。 作 业 和 异常 信息 包含 在 
事件 中 。 


因为 作业 执行 失败 ， 导 致 重 试 次 数 减 
少 。 作 业 包 含 在 事件 中 。 


触发 了 定时 器 。job 包 含 在 事件 中 。 
取消 了 一 个 作业 。 事 件 包含 取消 的 作 
业 。 作 业 可 以 通过 API 调 用 取消 ， 任务 
完成 后 对 应 的 边界 定时 器 也 会 取消 ， 在 
新 流程 定义 发 布 时 也 会 取消 。 

一 个 节点 开始 执行 

一 个 节点 成 功 结束 

要 取消 一 个 节点 。 取 消 是 因为 三 个 原因 
(MessageEventSubscriptionEntity, 


SignalEventSubscriptionEntity, 
TimerEntity) 


一 个 节点 收 到 了 一 个 信号 


一 个 节点 收 到 了 一 个 消息 。 在 节点 收 到 
消息 之 前 触发 。 收 到 后 ， 会 触发 


org. 


org. 


org. 


org. 


org. 


org. 


org 
and 
org 


org. 


org. 


org. 


org. 


org. 


“actlviti 


.activiti 


activiti 


wae tivibd 


activiti 


activitt 


QCEtLVItL 


activiti 


activiti 


activitt 


"aC EL 


activiti 


activiti 


QC ELVLt 


activiti 


activiti 


每 个 类 型 都 对 应 org.activiti.engine.delegate.event.ActivitiEventType 中 的 一 个 枚 举 


Event 类 


.. :ActivitiEvent 


.. .ActivitiEvent 


.. :ActivitiEntityEvent 


.. .ActivitiEntityEvent 


.. .ActivitiEntityEvent 


.. .ActivitiEntityEvent 


.. :ActivitiEntityEvent 


.. .ActivitiEntityEvent 


.. .ActivitiEntityEvent 
.. .ActivitiEntityEvent 


.. .ActivitiExceptionEvet 


.. .ActivitiEntityEvent 


.. .ActivitiEntityEvent 


.. .ActivitiEntityEvent 





.. .ActivitiActivityEvert 


.. .ActivitiActivityEve 


Org activiti.. 
ActivitiActivityCancelledEvent 


org.activiti...ActivitisignalEvent 
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ACTIVITY_MESSAGE_RECEIVED 


ACTIVITY_ERROR_RECEIVED 


UNCAUGHT_BPMN_ERROR 


ACTIVITY_COMPENSATE 


VARIABLE_CREATED 


VARIABLE_UPDATED 


VARIABLE_DELETED 


TASK_ASSICNED 


TASK_CREATED 


TASK_COMPLETED 


PROCESS_COMPLETED 


PROCESS_CANCELLED 


MEMBERSHIP_CREATED 


MEMBERSHIP_DELETED 


MEMBERSHIPS_DELETED 
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ACTIVITY_SIGNAL 或 
ACTIVITY_STARTED， 这 会 根据 节点 
(边界 事件 ， 事 件 子 流程 开始 事 
人 


一 个 节点 收 到 了 一 个 错误 事件 。 在 节点 
实际 处 理 错误 之 前 触发 。 事 件 的 
activityld 对 应 着 处 理 错 误 的 节点 。 这 个 
事件 后 续 会 是 ACTIVITY_SIGNALLED 
或 ACTIVITY_COMPLETE， 如 果 错 误 
发 送 成 功 的 话 。 


抛 出 了 未 捕获 的 BPMN 错 误 。 流 程 没有 
提供 针对 这 个 错误 的 处 理 器 。 事件 的 
activityld 为 空 。 


一 个 节点 将 要 被 补偿 。 
执行 补偿 的 节点 id。 


创建 了 一 个 变量 。 事 件 包含 变量 名 ， 变 
人 (如 果 存 
在 oo 


更 新 了 一 个 变量 。 事 件 包 含 变量 名 ， 变 
人 (如 果 存 
在 oo 


删除 了 一 个 变量 。 事 件 包含 变量 名 ， 变 
量 值 和 对 应 的 分 支 或 任务 (如果 存在 ) 


事件 包含 了 将 要 


创建 了 新 任务 。 它 位 于 
ENTITY_CREATE 事 件 之 后 。 当 任务 是 
由 流程 创建 时 ， 这 个 事件 会 在 
TaskListener 执 行 之 前 被 执行 。 


任务 被 完成 了 。 它 会 在 
ENTITY_DELETE 事 件 之 前 触发 。 当 任 
务 是 流程 一 部 分 时 ， 事 件 会 在 流程 继续 
运行 之 前 ， 后 续 事件 将 是 
ACTIVITY_COMPLETE， 对 应 着 完成 
任务 的 节点 。 


流程 已 结束 。 在 最 后 一 个 节点 的 
ACTIVITY_COMPLETED 事件 之 后 触 
发 。 当 流程 到 达 的 状态 ， 没 有 任何 后 续 
连 线 时 ， 流程 就 会 结 


流程 已 取消 。 在 流程 实例 删除 前 从 运行 
时 触发 。 流 程 实例 被 API 
RuntimeService.deleteProcesslnstance 
调用 


用 户 被 添加 到 一 个 组 里 。 事 件 包 含 了 用 
户 和 组 的 id。 


用 户 被 从 一 个 组 中 删除 。 事 件 包 含 了 用 
户 和 组 的 id。 


所 有 成 员 被 从 一 个 组 中 删除 。 在 成 员 删 
除 之 前 触发 这 个 事件 ， 所 以 他 们 都 是 可 
以 访问 的 。 因为 性 能 方面 的 考虑 ， 不 会 
为 每 个 成 员 触发 单独 的 
MEMBERSHIP_DELETED 事 件 。 


























org 


org 


org 


org 


org 


org 


org 


org. 


org. 


org. 


org. 


org. 


,acC 


,acC 


:BaC 


ac 


acC 


ac 


ac 


activiti. 








bt: 


Cin Es 


ET 


ELIE 


EEE 


FiViti; 


tiviti. 


activiti 


activiti 


activiti 


activiti 


. .ActivitiErrorEvent 


. .ActivitiActivityEver 


. .ActivitiVariableEver 


. .ActivitiVariableEver 


. .ActivitiVariableEver 


. .ActivitiEntityEvent 


. .ActivitiEntityEvent 


. .ActivitiEntityEvent 


.ActivitiEntityEvent 


.ActivitiCancelledEvent 


.. .ActivitiMembershipE, 


.. .ActivitiMembershipE, 


引擎 内 部 所 有 ENTITY_* 事件 都 是 与 实体 相关 的 。 下 面 的 列表 展示 了 实体 事件 与 实体 的 对 应 关系 : 


e ENTITY_CREATED, ENTITY_INITIALIZED, ENTITY_DELETED: Attachment, Comment, Deployment, Execution, 
Group, IdentityLink, Job, Model, ProcessDefinition, ProcessInstance, Task, User. 
e ENTITY_UPDATED: Attachment, Deployment, Execution, Group, IdentityLink, Job, Model, ProcessDefinition, 
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Processlnstance,， Task, User. 
e ENTITY_ SUSPENDED, ENTITY_ACTIVATED: ProcessDefinition, ProcessInstance/Execution, Task. 


Additional remarks 附加 信息 


只 有 事件 被 发 送 ， 对 应 的 引擎 内 的 监听 器 才 会 被 通知 到 。 你 有 很 多 引擎 - 在 同一 个 数据 库 运 行 - 事件 只 会 发 送 给 注册 到 对 应 
引擎 的 监听 器 。 其 他 引擎 发 生 的 事件 不 会 发 送 给 这 个 监听 器 ， 无 论 实际 上 它们 运行 在 同一 个 或 不 同 的 JVM 中 。 





对 应 的 事件 类 型 (对 应 实体 ) 都 包含 对 应 的 实体 。 根 据 类 型 或 事件 ， 这 些 实体 不 能 再 进行 更 新 〈 比 如 ， 当 实例 以 被 删除 ) 。 
可 能 的 话 ， 使 用 事件 提供 的 EngineServices 来 以 安全 的 方式 来 操作 引擎 。 即 使 如 此 ， 你 需要 小 心 的 对 事件 对 应 的 实体 进行 更 
新 /操作 。 


没有 对 应 历史 的 实体 事件 ， 因 为 它们 都 有 运行 阶段 的 对 应 实体 。 
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The Process Engine API and services 流程 引擎 的 API 和 服务 


引擎 API 是 与 Activiti 打交道 的 最 常用 方式 。 我 们 从 ProcessEngine 开始 ， 创建 它 的 很 多 种 方法 都 已 经 在 配置 章节 中 有 所 
涉及 。 从 ProcessEngine 中 ， 你 可 以 获得 很 多 吉 括 工作 流 /BPM 方法 的 服务 。 ProcessEngine 和 服务 类 都 是 线程 安全 的 。 
你 可 以 在 整个 服务 器 中 仅 保 持 它们 的 一 个 引用 就 可 以 了 。 


ProcessEngineConfiguration 


ProcessEngine 


RepositoryService TaskService IdentityService 


RuntimeService EDEN HistoryService 





ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); 


RuntimeService runtimeService = processEngine.getRuntimeService(); 
RepositoryService repositoryService = processEngine.getRepositoryService(); 
TaskService taskService = processEngine.getTaskService(); 

ManagementService managementService = processEngine.getManagementService(); 
IdentityService identityService = processEngine.getIdentityService(); 
HistoryService historyService = procesSsEngine,.getHistoryService() 
FormService formService = processEngine.getFormService(); 


ProcessEngines.getDefaultProcessEngine() 会 在 第 一 次 调用 时 初始 化 并 创建 一 个 流程 引擎 ， 以 后 再 调用 就 会 返回 相同 的 流 
程 引 擎 。 使 用 对 应 的 方法 可 以 创建 和 关闭 所 有 流程 引擎 : ProcessEngines.init() 和 ProcessEngines.destroy()。 


ProcessEngines 会 扫描 所 有 activiti.cfg.xml 和 activiti-context.xml 文件 。 对 于 activiti.cfg.xml 文件 ， 流 程 引 擎 会 使 用 Activiti 
的 经 典 方式 构建 : 
ProcessEngineConfiguration.createProcessEngineConfigurationFromlnputStream(inputStream).buildProcessEngine() 对 于 
activiti-context.xml 文件 ， 流 程 引擎 会 使 用 Spring 方法 构建 : 先 创建 一 个 Spring 的 环境 ， 然 后 通过 环境 获得 流程 引擎 。 


所 有 服务 都 是 无 状态 的 。 这 意味 着 可 以 在 多 节点 集群 环境 下 运行 ctiviti， 每 个 节点 都 指向 同一 个 数据 库 ， 不 用 担心 哪个 机 器 
实际 执行 前 端的 调用 。 无 论 在 哪里 执行 服务 都 没有 问题 。 


RepositoryService 可 能 是 使 用 Activiti 引擎 时 最 先 接 触 的 服务 。 它 提 供 了 管理 和 控制 发 布 包 和 流程 定义 的 操作 。 这 里 不 涉 
及 太 多 细节 ， 流 程 定义 是 BPMN 2.0 流程 的 Java 实现 。 它 包含 了 一 个 流程 每 个 环节 的 结构 和 行为 。 发 布 包 是 Activiti 引擎 
的 打包 单位 。 一 个 发 布 包 可 以 包含 多 个 BPMN 2.0 xml 文件 和 其 他 资源 。 开发 者 可 以 自由 选择 把 任意 资源 包含 到 发 布 包 中 。 
既 可 以 把 一 个 单独 的 BPMN 2.0 xml 文件 放 到 发 布 包 里 ， 也 可 以 把 整个 流程 和 相关 资源 都 放 在 一 起 。 (上 比如 ，'hr-processes' 
实例 可 以 包含 hr 流程 相关 的 任何 资源 ) 。 可 以 通过 RepositoryService 来 部 署 这 种 发 布 包 。 发 布 一 个 发 布 包 ， 意 味 着 把 它 上 
传 到 引擎 中 ， 所 有 流 程 都 会 在 保存 进 数据 库 之 前 分 析 解 析 好 。 从 这 点 来 说 ， 系 统 知道 这 个 发 布 包 的 存在 ， 发 布 包 中 包含 的 流 
程 就 已 经 可 以 启动 了 。 





除 此 之 外 ， 服 务 可 以 


e 查询 引擎 中 的 发 布 包 和 流程 定义 。 

e 暂停 或 激活 发 布 包 ， 对 应 全 部 和 特定 流程 定义 。 暂停 意味 着 它们 不 能 再 执行 任何 操作 了 ， 激 活 是 对 应 的 反 向 操作 。 
e 获得 多 种 资源 ， 像 是 包含 在 发 布 包 里 的 文件 ， 或 引擎 自动 生成 的 流程 图 。 

e 获得 流程 定义 的 pojo 版 本 ， 可 以 用 来 通过 java 解 析 流程 ， 而 不 必 通 过 xml。 
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正如 RepositoryService 负责 静态 信息 (比如 ， 不 会 改变 的 数据 ， 至 少 是 不 怎么 改变 的 ) ，RuntimeService 正好 是 完全 相反 
的 。 它 负责 启动 一 个 流程 定义 的 新 实例 。 如 上 所 述 ， 流 程 定义 定义 了 流程 各 个 节点 的 结构 和 行为 。 流程 实例 就 是 这 样 一 个 流 
程 定义 的 实例 。 对 每 个 流程 定义 来 说 ， 同 一 时 间 会 有 很 多 实例 在 执行 。 RuntimeService 也 可 以 用 来 获取 和 保存 流程 变量 。 
这 些 数据 是 特定 于 某 个 流程 实例 的 ， 并 会 被 很 多 流程 中 的 节点 使 用 〈 比 如， 一 个 排他 网 关 常 常 使 用 流程 变量 来 决定 选择 哪 条 
路 径 继续 流程 ) 。 Runtimeservice 也 能 查询 流程 实例 和 执行 。 执行 对 应 BPMN 2.0 中 的 'token'。 基 本 上 执行 指向 流程 实例 
当前 在 哪里 。 最 后 ，RuntimeService 可 以 在 流程 实例 等 待 外 部 触发 时 使 用 ， 这 时 可 以 用 来 继续 流程 实例 。 流程 实例 可 以 有 
很 多 暂停 状态 ， 而 服务 提供 了 多 种 方法 来 ' 触 发 ' 实 例 ， 接受 外 部 触发 后 ， 流 程 实例 就 会 继续 向 下 执行 。 


任务 是 由 系统 中 真实 人 员 执 行 的 ， 它 是 Activiti 这 类 BPMN 引擎 的 核心 功能 之 一 。 所 有 和 与 任务 有 关 的 功能 都 包含 
在 TaskService 中 : 


e 查询 分 配给 用 户 或 组 的 任务 

e 创建 独立 运行 任务 。 这 些 任务 与 流程 实例 无 关 。 

e 手工 设置 任务 的 执行 者 ， 或 者 这 些 用 户 通过 何 种 方式 与 任务 关联 。 

e 认领 并 完成 一 个 任务 。 认 领 意味 着 一 个 人 期 望 成 为 任务 的 执行 者 ， 即 这 个 用 户 会 完成 这 个 任务 。 完 成 意味 着 “做 这 个 任 
务 要 求 的 事情 "。 通常 来 说 会 有 很 多 种 处 理 形式 。 


IdentityService 非常 简单 。 它 可 以 管理 (创建 ， 更 新 ， 删 除 ， 查 询 ...) 群 组 和 用 户 。 请 注意 ， Activiti 执行 时 并 没有 对 用 户 
进行 检查 。 例如 ， 任 务 可 以 分 配给 任何 人 ， 但 是 引擎 不 会 校 验 系统 中 是 否 存在 这 个 用 户 。 这 是 Activiti 引擎 也 可 以 使 用 外 部 
服务 ， 比 如 ldap， 活 动 目录 ， 等 等 。 





FormService 是 一 个 可 选 服务 。 即 使 不 使 用 它 ，Activiti 也 可 以 完美 运行 ， 不 会 损失 任何 功能 。 这 个 服务 提供 了 启动 表单 和 任 
务 表单 两 个 概念 。 和 启动 表单 会 在 流程 实例 启动 之 前 展示 给 用 户 ， 任务 表单 会 在 用 户 完成 任务 时 展示 。Activiti 支持 在 BPMN 
2.0 流程 定义 中 设置 这 些 表单 。 这 个 服务 以 一 种 简单 的 方式 将 数据 暴露 出 来 。 再 次 重申 ， 它 是 可 选 的 ， 表单 也 不 一 定 要 内 入 
到 流程 定义 中 。 


HistoryService 提 供 了 Activiti 引擎 的 所 有 历史 数据 。 在 执行 流程 时 ， 引 擎 会 保存 很 多 数据 〈 根 据 配置 ) ， 上 比如 流程 实例 启 
动 时 间 ， 任 务 的 参与 者 ， 完成 任务 的 时 间 ， 每 个 流程 实例 的 执行 路 径 ， 等 等 。 这 个 服务 主要 通过 查询 功能 来 获得 这 些 数据 。 


ManagementService 在 使 用 Activiti 的 定制 环境 中 基本 上 不 会 用 到 。 它 可 以 查询 数据 库 的 表 和 表 的 元 数据 。 另 外 ， 它 提供 了 
查询 和 管理 异步 操作 的 功能 。 Activiti 的 异步 操作 用 途 很 多 ， 比 如 定时 器 ， 异 步 操作 ， 延迟 暂停 、 激 活 ， 等 等 。 后 续 ， 会 讨 


论 这 些 功能 的 更 多 细节 。 


可 以 从 javadocs 中 获得 这 些 服务 和 引擎 API 的 更 多 信息 。 
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Exception strategy 异常 策略 


Activiti 中 的 基础 异常 为 org.activiti.engine.ActivitiException， 一 个 非 检 查 异 常 。 这 个 异常 可 以 在 任何 时 候 被 API 抛 出 ， 不 过 
特定 方法 抛 出 的 “特定 "的 异常 都 记录 在 javadocs 中 。 例如 ， 下 面 的 TaskService : 


We 

* Called when the task is successfully executed. 

* @param taskId the id of the task to complete, cannot be null. 

* @throws ActivitiobjectNotFoundException when no task exists with the given id. 
A 

void complete(String taskId); 


在 上 面 的 例子 中 ， 当 传人 一 个 不 存在 的 任务 的 id 时 ， 就 会 抛 出 异常 。 同时 ，javadoc 明确 指出 taskld 不 能 为 null， 如 果 传 
入 null， 就 会 抛 出 ActivitilllegalArgumentException。 


我 们 希望 避免 过 多 的 异常 继承 ， 下 面 的 子 类 用 于 特定 的 场合 。 流程 引擎 和 API 调用 的 其 他 场合 不 会 使 用 下 面 的 异常 ， 它们 会 
抛 出 一 个 普通 的 ActivitiExceptions。 


e ActivitiWrongDbException : 当 Activiti 引擎 发 现 数据 库 版 本 号 和 引擎 版 本 号 不 一 致 时 抛 出 。 

e ActivitiOptimisticLockingException : 对 同一 数据 进行 并 发 方法 并 出 现 乐 观 锁 时 抛 出 。 

e ActivitiClassLoadingException : 当 无 法 找到 需要 加 载 的 类 或 在 加 载 类 时 出 现 了 错误 (比如 ，JavaDelegate， 
TaskListener 等 。) 

e ActivitiObjectNotFoundException : 当 请 求 或 操作 的 对 应 不 存在 时 抛 出 。 

e ActivitillegalArgumentException : 这 个 异常 表示 调用 Activiti API 时 传 入 了 一 个 非法 的 参数 ， 可 能 是 引擎 配置 中 的 非法 
值 ， 或 提供 了 一 个 非法 制 ， 或 流程 定义 中 使 用 的 非法 值 

e ActivitiTaskAlreadyClaimedException : 当 任务 已 经 被 认领 了 7， 再 调用 taskService.claim(…) 就 会 抛 出 。 
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Working with the Activiti services 使 用 Activiti 服务 


像 上 面 介绍 的 那样 ， 要 想 操 作 Activiti 引擎 ， 需 要 通过 org.activiti.engine.ProcessEngine 实例 暴露 的 服务 。 下 面 的 代码 假设 


你 已 经 拥有 了 一 个 可 以 运行 的 Activiti 环境 。 你 就 可 以 操作 一 个 org.activiti.engine.ProcessEngine。 如 果 只 想 简单 尝试 一 下 


代码 ， 可 以 下 载 或 者 复制 Activiti 单 元 测试 模板 ， 导 入 到 IDE 中 ， 把 testUserguideCode() 方法 添加 到 org.activiti.MyUnitTest 


中 。 


这 个 小 例子 的 最 终 目 标 是 做 一 个 工作 业务 流程 ， 演示 公司 中 简单 的 请 假 申请 : 






心 


Handle vacation 
request 



















${approved} ; 
PP | Send confirmation 


e-mail 





1 
1 






{iapproved} 
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Adjust vacation 
request 
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Deploying the process 部 署 流程 


任何 与 “静态 "资源 有 关 的 数据 (比如 流程 定义 ) 都 可 以 通过 RepositoryService 访 问 。 从 概念 上 讲 ， 所 以 静态 数据 都 是 
Activiti 的 资源 内 容 。 


在 src/test/resources/org/activiti/test 目录 下 创建 一 个 新 的 xml 文件 VacationRequest.bpmn20.xml (如 果 不 使 用 单元 测试 模 
板 ， 你 也 可 以 在 任何 地 方 创建 ) ， 内 容 如 下 。 注 意 这 一 章 不 会 解释 例子 中 使 用 的 xml 结构 。 如 果 有 需要 可 以 先 阅读 bpmn 
2.0 章 来 了 解 这 些 。 


<?xml version="1.0" encoding="UTF-8" ?> 

<definitions id="definitions" 
targetNamespace="http://activiti.org/bpmn20" 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:activiti="http://activiti.org/bpmn"> 


<process id="vacationRequest" name="Vacation request"> 
<startEvent id="request" activiti:initiator="employeeName"> 


<extensionElements> 
<activiti:formProperty id="numberOofDays" name="Number of days" type="long" value="1" required="true"/> 


<activiti:formproperty id="startDate" name="First day of holiday (dd-MM-yyy)" datePattern="dd-MM-yyyy hh:mm" ty 


<activiti:formproperty id="vacationMotivation" name="Motivation" type="string" /> 
</extensionElements> 
</startEvent> 
<sequenceFlow id="flowi1" sourceRef="request" targetRef="handleRequest" /> 


<userTask id="handleRequest" name="Handle vacation request" > 
<documentation> 
${employeeName} would like to take ${numberofDays} day(s) of vacation (Motivation: ${vacationMotivation}). 
</documentation> 
<extensionElements> 


<activiti:formproperty id="vacationApproved" name="Do you approve this vacation" type="enum" required="true"> 


<activiti:value id="true" name="Approve" /> 
<activiti:value id="false" name="Reject" /> 
</activiti:formproperty> 
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<activiti:formProperty id="managerMotivation" name="Motivation" type="string" /> 
</extensionElements> 
<potential0wner> 
<resourceAssignmentExpression> 
<formalExpression>management</formalExpression> 
</resourceAssignmentExpression> 
</potentialOwner> 
</userTask> 
<sequenceFlow id="flow2" sourceRef="handleRequest" targetRef="requestApprovedDecision" /> 


<exclusiveGateway id="requestApprovedDecision" name="Request approved?" /> 

<sequenceFlow id="flow3" sourceRef="requestApprovedDecision" targetRef="sendApprovalMail"> 
<conditionExpression xsi:type="tFormalExpression">${vacationApproved == 'true'}</conditionExpression> 

</sequenceFlow> 


<task id="sendApprovalMail" name="Send confirmation e-mail" /> 
<sequenceFlow id="flow4" sourceRef="sendApprovalMail" targetRef="theEnd1i" /> 
<endEvent id="theEndi" /> 


<sequenceFlow id="flow5" sourceRef="requestApprovedDecision" targetRef="adjustVacationRequestTask"> 
<conditionExpression xsi:type="tFormalExpression">${vacationApproved == 'false'}</conditionExpression> 
</sequenceFlow> 


<userTask id="adjustVacationRequestTask" name="Adjust vacation request"> 
<documentation> 
Your manager has disapproved your vacation request for ${numberofDays} days. 
Reason: ${managerMotivation} 
</documentation> 
<extensionElements> 
<activiti:formproperty id="numberOofDays" name="Number of days" value="${numberOofDays}" type="long" redquired="tr 
<activiti:formProperty id="startDate" name="First day of holiday (dd-MM-yyy)" value="${startDate}" datePattern: 
<activiti:formproperty id="vacationMotivation" name="Motivation" value="${vacationMotivation}" type="string" /> 
<activiti:formproperty id="resendRequest" name="Resend vacation request to manager?" type="enum" required="true 
<activiti:value id="true" name="Yes" /> 
<activiti:value id="false" name="No" /> 
</activiti:formproperty> 
</extensionElements> 
<humanPerformer> 
<resourceAssignmentExpression> 
<formalExpression>${employeeName}</formalExpression> 
</resourceAssignmentExpression> 
</humanPerformer> 
</userTask> 
<sequenceFlow id="flow6" sourceRef="adjustVacationRequestTask" targetRef="resendRequestDecision" /> 


<exclusiveGateway id="resendRequestDecision" name="Resend request?" /> 

<sequenceFlow id="flow7" sourceRef="resendRequestDecision" targetRef="handleRequest"> 
<conditionExpression xsi:type="tFormalExpression">${resendRequest == 'true'}</conditionExpression> 

</sequenceFlow> 


<sequenceFlow id="flow8" sourceRef="resendRequestDecision" targetRef="theEnd2"> 

<conditionExpression xsi:type="tFormalExpression">${resendRequest == 'false'}</conditionExpression> 
</sequenceFlow> 
<endEvent id="theEnd2" /> 


</process> 


</definitions> 
ER 


为 了 让 Activiti 引擎 知道 这 个 流程 ， 我 们 必须 先进 行 "部 署 "。 部 署 意味 着 引擎 会 把 BPMN 2.0 xml 解析 成 可 以 执行 的 东西 ， 
“部 署 包 ”中 的 所 有 流程 定义 都 会 添加 到 数据 库 中 。 这 样 ， 当 引擎 重启 时 ， 它 依然 可 以 获得 “已 部 署 "的 流程 : 





ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); 

RepositoryService repositoryService = processEngine.getRepositoryService(); 

repositoryService.createDeployment() 
.addclasspathResource("org/activiti/test/VacationRequest .bpmn20.xml") 
deploy(); 


Log.info("Number of process definitions: " + repositoryService.createprocessDefinitionQuery().count()); 


可 以 阅读 部 署 章 节 来 了 解 更 多 关于 部 署 的 信息 。 
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Starting a process instance 开始 流程 实例 


把 流程 定义 发 布 到 Activiti 引擎 后 ， 我 们 可 以 基于 它 发 起 新 流程 实例 。 对 每 个 流程 定义 ， 都 可 以 有 很 多 流程 实例 。 流程 定义 
是 “蓝图 ”， 流 程 实例 是 它 的 一 个 运行 的 执行 。 


所 有 与 流程 运行 状态 相关 的 东西 都 可 以 通过 RuntimeService 获得 。 有 很 多 方法 可 以 启动 一 个 新 流程 实例 。 在 下 面 的 代码 
中 ， 我 们 使 用 定义 在 流程 定义 xml 中 的 key 来 启动 流程 实例 。 我 们 也 可 以 在 流程 实例 启动 时 添加 一 些 流程 变量 ， 因 为 第 一 个 
用 户 任务 的 表达 式 需要 这 些 变量 。 流程 变量 经 常会 被 用 到 ， 因 为 它们 赋予 来 自 同一 个 流程 定义 的 不 同 流程 实例 的 特别 含义 。 
简单 来 说 ， 流 程 变量 是 区 分 流程 实例 的 关键 。 


Map<String, Object> variables = new HashMap<String, Object>(); 
variables.put("employeeName", "Kermit"); 
variables.put("numberOofDays", new Integer(4)); 
variables.put("vacationMotivation", "I'm really tired!") 


RuntimeService runtimeService = processEngine.getRuntimeService(); 
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("vacationRequest", variables); 


// Verify that we started a new process instance 
Log.info("Number of process instances: " + runtimeService.createProcessInstanceQuery().count()); 


Completing tasks 完成 任务 


流程 启动 后 ， 第 一 步 就 是 用 户 任务 。 这 是 必须 由 系统 用 户 处 理 的 一 个 环节 。 通常 ， 用 户 会 有 一 个 “任务 列表 ”， 展 示 了 所 有 须 
由 整个 用 户 处 理 的 任务 。 下 面 的 代码 展示 了 对 应 的 查询 可 能 是 怎样 的 : 


// Fetch all tasks for the management group 
TaskService taskService = processEngine.getTaskService(); 
List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("management").1ist(); 
for (Task task : tasks) { 
Log.info("Task available: " + task.getName()); 


} 


为 了 让 流程 实例 继续 运行 ， 我 们 需要 完成 整个 任务 。 对 Activiti 来 说 ， 就 是 需要 complete 任务 。 下 面 的 代码 展示 了 如 何 做 这 
件 事 : 


Task task = tasks.get(0); 


Map<String, Object> taskVariables = new HashMap<String, Object>(); 
taskVariables.put("vacationApproved", "false"); 
taskVariables.put("managerMotivation", "We have a tight deadline!"); 
taskService.complete(task.getId(), taskVvariables); 


流程 实例 会 进入 到 下 一 个 环节 。 在 这 里 例子 中 ， 下 一 环节 人 允许 员工 通过 表单 调整 原始 的 请 假 申 请 。 员 工 可 以 重新 提交 请 假 申 
请 ， 这 会 使 流程 重新 进入 到 第 一 个 任务 。 


Suspending and activating a process 挂 起 ， 激 活 一 个 流程 


我 们 可 以 挂 起 一 个 流程 定义 。 当 挂 起 流程 定时 时 ， 就 不 能 创建 新 流程 了 《会 抛 出 一 个 异常 ) 。 可 以 通过 RepositoryService 
挂 起 一 个 流程 


repositoryService.suspendProcessDefinitionByKey("vacationRequest"); 
Ery 

runtimeService.startProcessInstanceByKey("vacationRequest"); 
} catch (ActivitiException e) { 

e.printSstackTrace(); 


由 
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要 想 重 新 激活 一 个 流程 定义 ， 可 以 调用 repositoryService.activateProcessDefinitionXXX 方法 。 也 可 以 挂 起 一 个 流程 实例 。 挂 
起 时 ， 流 程 不 能 继续 执行 (上 比如， 完成 任务 会 抛 出 异常 ) ， 异步 操作 (比如 定时 器 ) 也 不 会 执行 。 挂 起 流程 实例 可 以 调用 
runtimeService.suspendProcesslnstance 方法 。 激活 流程 实例 可 以 调用 runtimeService.activateProcesslnstanceXXX 方 


法 。 
Further reading 扩展 阅读 


上 面 章节 中 我 们 仅仅 覆盖 了 Activiti 功能 的 表层 。 未 来 我 们 会 继续 扩展 这 些 章节 ， 以 覆盖 更 多 Activiti API。 当然 ， 像 其 他 开 
源 项 目 一 样 ， 学 习 的 最 好 方式 是 研究 代码 ， 阅 读 Javadocs。 
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Query API 查询 API 


有 两 种 方法 可 以 从 引擎 中 查询 数据 : 查询 API 和 原生 查询 。 查 询 API 提供 了 完全 类 型 安全 的 APIl。 你 可 以 为 自己 的 查询 条 件 
添加 很 多 条 件 (所 有 条 件 都 以 AND 组 合 ) 和 精确 的 排序 条 件 。 下 面 的 代码 展示 了 一 个 例子 : 


List<Task> tasks = taskService.createTaskQuery() 
.taskAssignee("kermit") 
.processVvariablevalueEquals("orderId", "0815") 
.orderByDueDate().asc() 

SEN) 


有 时 ， 你 需要 更 强大 的 查询 ， 上 比如 使 用 OR 条 件 或 不 能 使 用 查询 API 实现 的 条 件 。 这 时 ， 我 们 推荐 原生 查询 ， 它 让 你 可 以 编 
写 自 己 的 SQL 查 询 。 返回 类 型 由 你 使 用 的 查询 对 象 决定 ， 数 据 会 映射 到 正确 的 对 象 上 。 上 比如 ， 任 务 ， 流 程 实例 ， 执 行 ， 等 
等 。 因为 查询 会 作用 在 数据 库 上 ， 你 必须 使 用 数据 库 中 定义 的 表 名 和 列 名 ; 这 要 求 了 解 内 部 数据 结构 ， 因此 使 用 原生 查询 
时 一 定 要 注意 。 表 名 可 以 通过 API 获得 ， 可 以 尽量 减少 对 数据 库 的 依赖 。 


List<Task> tasks = taskService.createNativeTaskQuery() 
.Sq1l("SELECT count(*) FROM " + managementService.getTableName(Task.class) + " T WHERE T.NAME = #{taskName}") 
.parameter("taskName", "gonzoTask") 
lS (DS 


long count = taskService.createNativeTaskQuery() 
.SqlL("SELECT count(*) FROM " + managementService.getTableName(Task.class) + " T1i, " 
+ managementService.getTableName(VariableInstanceEntity.class) + " V1 WHERE V1.TASK_ID = T1.ID_") 
.Ccount(); 
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Variables 六 


每 个 流程 实例 需要 并 且 使 用 数据 来 执行 存在 的 步骤 。 在 Activiti, 这些 数据 称 为 variables (变量 ) ,并 存储 在 数据 库 中 。 变 量 可 
用 于 表达 式 ( 例 如 在 单独 的 网 关中 选择 正确 的 流出 序列 流 ), 在 java 服务 任务 调用 外 部 服务 (例如 提供 输入 或 存储 服务 调用 的 结 
果 ), 等 等 。 











一 个 流程 实例 可 以 有 变量 ( 称 为 process variables 流程 变量 ), 但 也 可 以 执行 (流程 是 活动 的 特定 指针 ) 并 且 用 户 任 务 可 以 有 变 
。 一 个 流程 实例 可 以 拥有 任意 数量 的 变量 。 每 个 变量 存储 在 ACT_RU_VARIABLE 数据 库 表 中 的 一 行 。 





la 


任何 StartProcesslnstanceXXX 方法 都 有 一 个 可 选 的 参数 来 提供 变量 ， 当 流程 实例 创建 和 开始 时 。 例 如 , RuntimeService: 


ProcessInstance startProcessInstanceByKey(String processDefinitionKey, Map<String, Object> variables) 


在 流程 执行 时 可 以 添加 变量 。 例 如 (RuntimeService): 


void setVvariable(String executionId, String variableName, Object value); 

void setVariableLocal(String executionId, String variableName, Object value); 

void setVariables(String executionId, Map<String, ? extends Object> variables); 

void setVariablesLocal(String executionId, Map<String, ? extends Object> variables); 


注意 变量 可 以 设置 在 本 地 ， 对 于 一 个 给 定 的 执行 ( 记 住 一 个 流程 实例 由 一 个 执行 树 组 成 )。 变 量 只 在 执行 时 可 见 ,并 且 不 会 高 
执行 树 。 当 数据 不 应 该 传播 到 流程 实例 级 别 , 或 变量 有 在 流程 实例 中 特定 路 径 的 新 值 (例如 当 使 用 并 行路 径 时 )， 这 可 能 是 有 用 
的 。 


变量 也 可 以 再 次 获取 ,如 下 所 示 。 注 意 ,类 似 的 方法 在 TaskService 存在 。 这 意味 着 任务 跟 执行 一 样 ,可 以 使 用 局 部 变量 ,为 了 任 
务 的 持续 时 间 而 alive (存活 )。 


Map<String, Object> getVariables(String executionId); 

Map<String, Object> getVariablesLocal(String executionId); 

Map<String, Object> getVariables(String executionId, Collection<String> variableNames); 
Map<String, Object> getVariablesLocal(String executionId, Collection<String> variableNames); 
Object getVariable(String executionId, String variableName); 

<T> T getVariable(String executionId, String variableName, Class<T> variableClass); 


变量 经 常 使 用 在 Java delegates, 表达 式 , execution- 或 者 tasklisteners ,脚本 ,等 等 。 在 这 些 结构 ,当前 执行 或 任务 对 象 是 可 用 
的 , 它 可 以 用 于 变量 设置 和 /或 检索 。 最 简单 的 方法 是 : 


execution.getVariables(); 
execution.getVariables(Collection<String> variableNames); 
execution.getVariable(String variableName); 


execution,setVariables(Map<String, object> variables); 
execution.setVariable(String variableName, Object value); 


注意 ,本 地 变 体 也 可 用 于 上 述 所 有 。 


历史 (和 向 后 兼容 的 原因 ), 在 上 面 的 任何 调用 ,实际 上 在 幕后 所 有 变量 将 从 数据 库 中 获取 。 这 意味 着 ,如 果 你 有 10 个 变量 ,并 通过 
getVariable("myVariable") 只 有 一 次 ,在 幕后 其 他 9 个 将 获取 和 缓存 。 这 不 是 坏事 ,因为 后 续 调 用 不 会 再 接触 到 数据 库 。 例 如 , 当 
您 的 流程 定义 有 三 个 连续 的 服务 任务 (因此 有 一 个 数据 库 事 务 ), 使 用 一 个 调用 来 获取 所 有 变量 在 第 一 个 服务 任务 的 时 候 ， 这 桩 
可 能 比 在 每 个 服务 任务 分 别 获取 所 需 的 变量 要 好 。 注 意 ,这 个 占用 在 获取 和 设置 变量 时 。 


当然 , 当 使 用 大 量 的 变量 或 者 只 是 当 您 想 要 严格 控制 数据 库 查 询 和 交互 的 时 候 , 这 是 不 合适 的 。Activiti 5.17 以 来 ,新 方法 介绍 了 
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给 一 个 更 严格 的 控制 ,通过 添加 一 个 可 选 参数 的 新 方法 ,告诉 引擎 是 否 需要 在 幕后 将 所 有 变量 获取 并 缓存 : 


Map<String, Object> getVvariables(Collection<String> variableNames, boolean fetchAllVariables); 
Object getVariable(String variableName, boolean fetchAllVariables); 
void setVariable(String variableName, Object value, boolean fetchAllVvariables); 


当 参 数 fetchAllVariables 为 true 时 ,上 述 行为 将 完全 一 样 : 当 获 取 或 设置 一 个 变量 ,所 有 其 他 变量 将 获取 和 缓存 。 


然而 , 当 值 是 false 时 ,将 使 用 特定 的 查询 ， 其 他 变量 将 不 会 获取 和 缓存 。 只 有 当前 问题 的 变量 的 值 将 缓存 为 后 续 使 用 。 
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Expressions 表达 式 


Activiti 使 用 UEL 处 理 表 达 式 。UEL 即 Unified Expression Language (统一 表达 式 语言 )， 它 是 EE6 规范 的 一 部 分 (参考 
EE6 规 范 ) 。 为 了 在 所 有 运行 环境 都 支持 最 新 UEL 的 所 有 功能 ， 我 们 使 用 了 一 个 JUEL 的 修改 版 本 。 


表达 式 可 以 用 在 很 多 场景 下 ， 上 比如 Java 服务 任务 ， 执 行 监听 器 ， 任 务 监听 器 和 条 件 流 。 虽然 有 两 重 表达 式 ， 值 表达 式 和 方 
法 表达 式 ，Activiti 进 行 了 抽象 ， 所 以 两 者 可 以 同样 使 用 在 需 要 表达 式 的 场景 中 。 


e。 Value expression( 值 表达 式 ) : 解析 为 值 。 默 认 ， 所 有 流程 变量 都 可 以 使 用 。 所 有 spring bean (Spring 环境 中 ) 也 可 以 使 
用 在 表达 式 中 。 一 些 实例 : 


${myVar} ${myBean.myProperty} 


e Method expression( 方 法 表达 式 ) : 调用 一 个 方法 ， 使 用 或 不 使 用 参数 。 当 调用 一 个 无 参数 的 方法 时 ， 记 得 在 方法 名 后 添 
加 空 的 括号 (以 区 分 值 表达 式 ) 。 传递 的 参数 可 以 是 字符 串 也 可 以 是 表达 式 ， 它 们 会 被 自动 解析 。 例 子 : 


${printer.print()} ${myBean.addNewOrder('orderName'")} ${myBean.doSomething(myVar, execution)} 
注意 这 些 表达 式 支持 解析 原始 类 型 (包括 比较 ) ，bean，list， 数 组 和 map。 
在 所 有 流程 实例 中 ， 表 达 式 中 还 可 以 使 用 一 些 默认 对 象 : 
e execution : DelegateExecution 提供 外 出 执行 的 额外 信息 。 
e task : DelegateTask 提供 当前 任务 的 额外 信息 。 注 意 ， 只 对 任务 监听 器 的 表达 式 有 效 。 


e authenticatedUserld : 当前 登录 的 用 户 id。 如 果 没 有 用 户 登 录 ， 这 个 变量 就 不 可 用 。 


想 要 更 多 具体 的 使 用 方式 和 例子 ， 参 考 spring 中 的 表达 式 ，Java 服务 任务 ， 执 行 监听 器 ， 任 务 监听 器 和 条 件 流 。 
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Unit testing 单元 测试 


业务 流程 是 软件 项 目的 一 部 分 ， 它 也 应 该 和 普通 的 业务 流程 一 样 进 行 测 试 : 使 用 单元 测试 。 因 为 Activiti 是 一 个 藤 入 式 的 
java 引擎 ， 为 业务 流程 编写 单元 测试 和 写 普 通 单元 测试 完全 一 样 。 


Activiti 支持 JUnit 3 和 4 进行 单元 测试 。 使 用 JUnit 3 时 ， 必须 集成 org.activiti.engine.test.ActivitiTestCase。 它 通过 保护 的 成 
员 变 量 提供 ProcessEngine 和 服务 ， 在 测试 的 setup() 中 ， 默认 会 使 用 classpath 下 的 activiti.cfg.xml 初始 化 流程 引擎 。 想 
使 用 不 同 的 配置 文件 ， 可 以 重 写 getConfigurationResource() 方法 。 如 果 配 置 文件 相同 的 话 ， 对 应 的 流程 引擎 会 被 静态 组 
存 ， 就 可 以 用 于 多 个 单元 测试 。 


继承 了 ActivitiTestCase, 你 可 以 在 测试 方法 上 使 用 org.activiti.engine.test.Deployment 注解 。 测 试 执行 前 ， 与 测试 类 在 同一 个 
包 下 的 ， 格式 为 testClassName.testMethod.bpmn20.xml 的 资源 文件 ， 会 被 部 署 。 测试 结束 后 ， 发 布 包 也 会 被 删除 ， 包 括 所 
有 相关 的 流程 实例 ， 任 务 ， 等 等 。Deployment 注解 也 可 以 直接 设置 资源 的 位 置 。 参考 Javadocs 获得 更 多 信息 。 


把 这 些 放 在 一 起 ，JUnit 3 测试 看 起 来 像 这 样 。 


public class MyBusinessProcessTest extends ActivitiTestCase { 


@Deployment 
public void testSimpleProcess() { 
runtimeService.startProcessInstanceByKey("simpleProcess"); 


Task task = taskService.createTaskQuery().singleResult(); 
assertEquals("My Task", task.getName()); 


taskService.complete(task.getId()); 
assertEquals(0, runtimeService.createpProcessInstanceQuery().count()); 


要 想 在 使 用 JUnit 4 编写 单元 测试 时 获得 同 祥 的 功能 ， 可 以 使 用 org.activiti.engine.test.ActivitiRule。 通过 它 ， 可 以 通过 
getter 方法 获得 流程 引擎 和 各 种 服务 。 和 ActivitiTestCase 一 样 (参考 上 面 章节 ) ， 使 用 这 个 Rule 也 会 启用 
org.activiti.engine.test.Deployment 注解 〈 参 考 上 面 章节 使 用 和 配置 的 介绍 ) ， 它 会 在 classpath 下 查找 默认 的 配置 文件 。 
如 果 配 置 文件 相同 的 话 ， 对 应 的 流程 引擎 会 被 静态 缓存 ， 就 可 以 用 于 多 个 单元 测试 。 


下 面 的 代码 演示 了 JUnit 4 单元 测试 并 使 用 了 ActivitiRule 的 例子 。 


public class MyBusinessProcessTest { 


Q@Rule 
public ActivitiRule activitiRule = new ActivitiRule(); 


@Test 

@Deployment 

public void ruleUsageExample() { 
RuntimeService runtimeService = activitiRule.getRuntimeService(); 
runtimeService.startProcessInstanceByKey("ruleUsage"); 


TaskService taskService = activitiRule.getTaskService(); 
Task task = taskService.createTaskQuery().singleResult(); 


assertEquals("My Task", task.getName()); 


taskService.complete(task.getId()); 
assertEquals(0, runtimeService.createpProcessInstanceQuery().count()); 
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Debugging unit tests 调试 单元 测试 


当 使 用 内 存 数据 库 H2 进行 单元 测 斌 时， 下面 的 教程 会 告诉 我 们 如 何在 调试 环境 下 更 容易 的 监视 Activiti 的 数据 库 。 这 里 的 
截图 都 是 基于 eclipse， 这 种 机 制 很 容易 复 用 到 其 他 IDE 下 。 


假设 我 们 已 经 在 单元 测试 里 设置 了 一 个 断 点 。 Ecilpse 里 ， 在 代码 左 侧 双击 : 
27 public void testSimpleProcess() { 
28 runtimeService.startProcessInstanceByKey("simpleProcess"); 
29 
30 Task task = taskService.createTaskQuery().singleResult(); 
©31 assertEquals("My Task", task.getName()); 
37 


现在 用 调试 模式 运行 单元 测试 ( 右 击 单元 测试 ， 选择 “运行 为 "和 "单元 测试 ") ， 测 试 会 停 在 我 们 的 断 点 上 ， 然后 我 们 就 可 以 
监视 测试 的 变量 ， 它 们 显示 在 右 侧 面板 里 。 

















菏 pebug 3 册 园 去 | 了 双 | 33 96 Breakpoints | wh 
Vv JuActivitiTestCaseTest [JUnit] Name Value 
Torg.eclipse.jdt.internal.junit.runner.RemoteTestRunner at localhost:51256 0 pb © this ActivitiTestCaseTest 
Vo Thread [main] (Suspended (breakpoint at line 31 in ActivitiTestCaseTest)) vO task TaskEntity (id=31) 

三 ActivitiTestCaseTest.testSimpleProcess() line: 31 © assignee null 
三 NativeMethodAccessorlmpl.invoke0(Method, Object, Object[]) line: not av © cachedEIContext null 
三 NativeMethodAccessorlmpl.invoke(Object, Object[]) line: 39 by 

三 DelegatingMethodAccessorImpl.invoke(Object, Object[]) line: 25 入 





三 Method.invoke(Obiect,Obiect...) line: 597 了 
J 4 
| 四 *cho5-Apl.xml 国 ActivitiTestCaseTestjava 3 


25 他 

26 昌  @Deployment 

27 public void testSimpleProcess() { 

28 runtimeService.startProcessInstanceByKey("simpleProcess"); 四 
a 
下 














30 Task task = taskService.createTaskQuery().singleResult(); 
sk", task.getNameC)); 


D3l assertEquals("My Task" 





要 监视 Activiti 的 数据 ， 打 开 “ 显 示 "” 窗 口 (如 果 找 不 到 ， 打 开 “ 窗 口 "->“ 显 示 视 图 ”->“ 其 他 "”， 选 择 显示 。) 并 点 击 (代码 已 完 
成 ) 


org.h2.tools.Server.createWebServer("-web").start() 








全 Inspect 仓 虹 | 


J EW 他 四 DD 


OQ; Execute $eU 
3Y Watch 


选择 你 点 击 的 行 ， 右 击 。 然 后 选择 “显示 ”( 或 者 直接 快捷 方式 就 不 用 右 击 了 ) 








Q Inspect 仓 虹 | 

前 Display 个 中 D P 
OQ; Execute 8 嘴 U = 
3Y Watch 





现在 打开 一 个 浏览 器 ， 打 开 http://localhost:8082 ， 输入 内 存 数据 库 的 JDBC URL (默认 为 jdbc:h2:mem:activiti ) ， 点 击 连 
接 按 钮 。 
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Saved Settings: 
SetingName: [GenercH2(Embedded) | 
Driver Class: ‘org.h2.Driver ! 
a 
User Name: [sa 
Password: | 

Test Connection 











你 现在 可 以 看 到 Activiti 的 数据 ， 通 过 它们 可 以 了 解 单元 测试 时 如 何以 及 为 什么 这 样 运行 的 。 


目 jdbc:h2:mem:activiti (alear ) SQL statement: 
国 ACT_GE_BYTEARRAY SELECT * FROM ACT_RU_TASK 

国 ACT_GE_PROPERTY 
国 ACT_HI_ACTINST 

国 ACT_HI_DETAIL 

国 ACT_HI_PROCINST 
国 ACT_HI_TASKINST 

国 ACT_ID_GROUP 

国 ACT_ID_MEMBERSHIP 
国 ACT_ID_USER 

国 ACT_RE_DEPLOYMENT SELECT * FROM ACT RU TASK: 
国 ACT_RE_PROCDEF TION 
国 ACT-RU_EXECUTION SimpleProcess:1:3 My Task null 
国 ACT_RU_IDENTITYLINK (1 row, 6 ms) 

国 ACT_RU_JOB 


国 ACT_RU_TASK 


国 ACT RU VARIABLE 


由 由 由 由 


由 由 


由 由 








由 田 





由 由 








由 四 由 由 
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The process engine in a web application 在 web 应 用 中 的 流程 
引擎 


ProcessEngine 是 线程 安全 的 ， 可 以 在 多 线程 下 共享 。 在 web 应 用 中 ， 意味 着 可 以 在 容器 启动 时 创建 流程 引擎 ， 在 容器 关 
闭 时 关闭 流程 引擎 。 下 面 代 码 演示 了 如 何 编写 一 个 ServletContextListener 在 普通 的 Servlet 环境 下 初始 化 和 销毁 流程 引擎 : 


public class ProcessEnginesServletContextListener implements ServletContextListener { 


public void contextInitialized(ServletContextEvent servletContextEvent) { 
ProcessEngines.init(); 


此 


public void contextDestroyed(ServletContextEVvent servletContextEvent) { 
ProcessEngines.destroy(); 


» 


contextlnitialized 方法 会 执行 ProcessEngines.init()。 这 会 查找 classpath 下 的 activiti.cfg.xml 文 件 ， 根据 配置 文件 创建 一 
个 ProcessEngine (比如 ， 多 个 jar 中 都 包含 配置 文件 ) 。 如 果 classpath 中 包含 多 个 配置 文件 ， 确 认 它 们 有 不 同 的 名 字 。 
当 需 要 使 用 流程 引擎 时 ， 可 以 通过 


ProcessEngines.getDefaultProcessEngine() 
或 者 
ProcessEngines.getProcessEngine("myName"); 


当然 ， 也 可 以 使 用 其 他 方式 创建 流程 引擎 ， 可 以 参考 配置 章节 中 的 描述 。 


ContextListener 中 的 contextDestroyed 方法 会 执行 ProcessEngines.destroy() ， 这 会 关闭 所 有 初始 化 的 流程 引擎 。 
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Chapter 5. Spring integration 集成 Spring 





虽然 没有 Spring 你 也 可 以 使 用 Activiti， 但 是 我 们 提供 了 一 些 非常 不 错 的 集成 特性 。 这 一 章 我 们 将 介绍 这 些 特性 。 





Chapter 5. Spring integration 集成 Spring 
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ProcessEngineFactoryBean 


可 以 把 ProcessEngine 作为 一 个 普通 的 Spring bean 进行 配置 。 类 org.activiti.spring.ProcessEngineFactoryBean 是 集成 的 
切入 点 。 这 个 bean 需要 一 个 流程 引擎 配置 来 创建 流程 引擎 。 这 也 意味 着 在 文档 的 配置 这 一 章 的 介绍 属性 的 创建 和 配置 对 于 
Spring 来 说 也 是 一 样 的 。 对 于 Spring 集成 的 配置 和 流程 引擎 bean 看 起 来 像 这 样 : 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
</bean> 
<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean"> 


<property name="processEngineConfiguration" ref="processEngineConfiguration" /> 
</bean> 


注意 现在 processEngineConfiguration 的 bean 是 使 用 org.activiti.spring.SpringProcessEngineConfiguration 类 。 
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Transactions 事务 


我 们 将 会 一 步 一 步 地 解释 在 Spring examples 中 公布 的 SpringTransactionlntegrationTest 下 面 是 我 们 使 用 这 个 例子 的 Spring 
配置 文件 〈 你 可 以 在 SpringTransactionlntegrationTestcontext.xml 找 到 它 ) 以 下 展示 的 部 分 包括 数据 源 (dataSource) ， 事 
务 管理 器 (transactionManager) ， 流 程 引擎 〈processEngine) 和 Activiti 引擎 服务 。 


当 把 数据 源 (DataSource) 传递 给 SpringProcessEngineConfiguration (使 用 "dataSource" 属 性 ) 之 后 ，Activiti 内 部 使 用 了 
一 个 org.springframework.jdbc.datasource.TransactionAwareDataSourceProxy 代理 来 封装 传递 进来 的 数据 源 
(DataSource) 。 这 样 做 是 为 了 确保 从 数据 源 (DataSource) 获取 的 SQL 连接 能 够 与 Spring 的 事物 结合 在 一 起 发 挥 得 更 出 
色 。 这 意味 它 不 再 需要 在 你 的 Spring 配置 中 代理 数据 源 (dataSource) 了 。 然而 它 仍然 允许 你 传递 一 个 
TransactionAwareDataSourceProxy 到 SpringProcessEngineConfiguration 中 。 在 这 个 例子 中 并 不 会 发 生 多 余 的 包装 。 


为 了 确保 在 你 的 Spring 配置 中 申明 的 一 个 TransactionAwareDataSourceProxy， 你 不 能 把 使 用 它 的 应 用 交 给 Spring 事物 
控制 的 资源 。 (例如 DataSourceTransactionManager 和 JPATransactionManager 需要 非 代 理 的 数据 源 ) 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:context="http://www.springframework.org/schema/context" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/sr 
http://www.springframework.org/schema/context http://www.springframework.org/schema/context, 
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/sprir 


<bean id="dataSource" class="org.springframework.jdbc.datasource.SimpleDriverDataSource"> 
<property name="driverClass" value="org.h2.Driver" /> 
<property name="url" value="jdbc:h2:mem:activiti;DB_CLOSE_ DELAY=1000" /> 
<property name="username" value="sa" /> 
<property name="password" value="" /> 
</bean> 


<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> 
<property name="dataSource" ref="dataSource" /> 
</bean> 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="dataSource" ref="dataSource" /> 
<property name="transactionManager" ref="transactionManager" /> 
<property name="databaseSschemaUpdate" value="true" /> 
<property name="jobExecutorActivate" value="false" /> 
</bean> 





<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean"> 
<property name="processEngineConfiguration" ref="processEngineConfiguration" /> 
</bean> 


<bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" /> 
<bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" /> 

<bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" /> 

<bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" /> 

<bean id="managementService" factory-bean="processEngine" factory-method="getManagementService" /> 





Spring 配置 文件 的 其 余部 分 包含 beans 和 我 们 将 要 在 这 个 特有 的 例子 中 的 配置 : 


<beans> 
<tx:annotation-driven transaction-manager="transactionManager"/> 
<bean id="userBean" class="org.activiti.spring.test.UserBean"> 


<property name="runtimeService" ref="runtimeService" /> 
</bean> 
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<bean id="printer" class="org.activiti.spring.test.Printer" /> 


</beans> 


首先 使 用 任意 的 一 种 Spring 创建 应 用 上 下 文 的 方式 创建 其 Spring 应 用 上 下 文 。 在 这 个 例子 中 你 可 以 使 用 类 路 径 下 面 的 XML 
资源 来 配置 我 们 的 Spring 应 用 上 下 文 : 


ClassPathXmlApplicationContext applicationContext = 
new ClassPpathxXmlApplicationContext("org/activiti/examples/spring/SpringTransactionIntegrationTest-context .xm1") ， 


OSS_SSSS E 小 ， 


或 者 , 如 果 它 是 一 个 测试 的 话 : 


@Contextconfiguration("classpath:org/activiti/spring/test/transaction/SpringTransactionIntegrationTest-context.xml") 
加 于 = 汪汪 到 


然后 我 们 就 可 以 得 到 Activiti 的 服务 beans 并 且 调 用 该 服务 上 面 的 方 法 。ProcessEngineFactoryBean 将 会 对 该 服务 添加 一 
些 额外 的 拦截 器 ， 在 Activiti 服务 上 面 的 方法 使 用 的 是 Propagation.REQUIRED 事物 语义 。 所 以 ， 我 们 可 以 使 用 
repositoryService 去 部 署 一 个 流程 ， 如 下 所 示 : 


RepositoryService repositoryService = (RepositoryService) applicationCcontext .getBean("repositoryService" ) ; 
String deploymentId = repositoryService 

.CreateDeployment() 

.addcClasspathResource("org/activiti/spring/test/hello.bpmn20.xml") 

.deploy() 

.getId(); 


其 他 相同 的 服务 也 是 同样 可 以 这 么 使 用 。 在 这 个 例子 中 ，Spring 的 事物 将 会 围绕 在 userBean.hello() 上 ， 并 且 调 用 Activiti 
服务 的 方法 也 会 加 入 到 这 个 事物 中 。 


UserBean userBean = (UserBean) applicationContext.getBean("userBean"); 
userBean.hello(); 


这 个 UserBean 看 起 来 像 这 样 。 记 得 在 上 面 Spring bean 的 配置 中 我 们 把 repositoryService 注入 到 userBean 中 。 


public class UserBean { 


/** injected by Spring */ 
private RuntimeService runtimeService; 


@Transactional 
public void hello() { 
// here you can do transactional stuff in your domain model 
// and it will be combined in the same transaction as 
// the startProcessIinstanceByKey to the Activiti RuntimeService 
runtimeService.startProcessInstanceByKey("hellopProcess"); 


四 


public void setRuntimeService(RuntimeService runtimeService) { 
this.runtimeService = runtimeService; 
上 
3 
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Expressions 表达 式 


当 使 用 ProcessEngineFactoryBean 时 候 ， 默 认 情况 下 ， 在 BPMN 流程 中 的 所 有 表达 式 都 将 会 ' 看 见 ' 所 有 的 Spring beans。 
它 可 以 限制 你 在 表达 式 中 暴露 出 的 beans 或 者 甚至 可 以 在 你 的 配置 中 使 用 一 个 Map 不 暴露 任何 beans。 下 面 的 例子 暴露 了 
一 个 单 例 bean (printer) ， 可 以 把 "printer" 当 作 关键 字 使 用 。 想 要 不 暴露 任何 beans， 仅 仅 只 需要 在 
SpringProcessEngineConfiguration 中 传递 一 个 空 的 list 作为 'beans' 的 属性 。 当 不 设置 'beans' 的 属性 时 ， 在 应 用 上 下 文 
中 Spring beans 都 是 可 以 使 用 的 。 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="beans"> 
<map> 
<entry key="printer" value-ref="printer" /> 
</map> 
</property> 
</bean> 


<bean id="printer" class="org.activiti.examples.spring.Printer" /> 


现在 暴露 出 来 的 beans 就 可 以 在 表达 式 中 使 用 : 例如 ， 在 SpringTransactionlntegrationTest 中 的 hello.bpmn20.xml 展示 的 
是 如 何 使 用 UEL 方法 表达 式 去 调用 Spring bean 的 方法 : 


<definitions id="definitions" ...> 
<process id="helloProcess"> 


<startEvent id="start" /> 
<sequenceFlow id="flow1" sourceRef="start" targetRef="print" /> 


<serviceTask id="print" activiti:expression="#{printer.printMessage()}" /> 
<sequenceFlow id="flow2" sourceRef="print" targetRef="end" /> 


<endEvent id="end" /> 
</process> 


</definitions> 


这 里 的 Printer 看 起 来 像 这 样 : 


public class Printer { 


public void printMessage() { 
System.out .println("hello world"); 
} 
此 


并 且 Spring bean 的 配置 (如 上 文 所 示 ) 看 起 来 像 这 样 : 


<beans ...> 


<bean id="printer" class="org.activiti.examples.spring.Printer" /> 


</beans> 
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Automatic resource deployment 资源 自动 部 署 


Spring 的 集成 也 有 一 个 专门 用 于 对 资源 部 署 的 特性 。 在 流程 引擎 的 配置 中 ， 你 可 以 指定 一 组 资源 。 当 流程 引擎 被 创建 的 时 
候 ， 所 有 在 这 里 的 资源 都 将 会 被 自动 扫描 与 部 署 。 在 这 里 有 过 滤 以 防止 资源 重新 部 署 ， 只 有 当 这 个 资源 真正 发 生 改 变 的 时 
候 ， 它 才 会 向 Activiti 使 用 的 数据 库 创 建新 的 部 署 。 这 对 于 很 多 用 例 来 说 ， 当 Spring 容器 经 常 重启 的 情况 下 〈 例 如 测试 ) ， 
使 用 它 是 非常 不 错 的 选择 。 


这 里 有 一 个 例子 : 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 


<property name="deploymentResources" value="classpath*:/org/activiti/spring/test/autodeployment/autodeploy.*.bpmn20.>» 
</bean> 


<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean"> 
<property name="processEngineConfiguration" ref="processEngineConfiguration" /> 
</bean> 


加 二 = 
默认 ， 上 面 的 配置 会 把 所 有 匹配 的 资源 发 布 到 Activiti 引擎 的 一 个 单独 发 布 包 下 。 用 来 检测 防止 未 修改 资源 重复 发 布 的 机 制 会 
作用 到 整个 发 布 包 中 。 有 时 候 ， 这 可 能 不 是 你 想 要 的 。 上 比如， 如果 你 发 布 了 很 多 流程 资源 ， 但 是 只 修改 里 其 中 某 一 个 单独 的 


流程 定义 ， 整个 发 布 包 都 会 被 认为 变更 了 ， 导 致 整个 发 布 包 下 的 所 有 流程 定义 都 会 被 重新 发 布 ， 结果 就 是 每 个 流程 定义 都 生 
成 了 新 版 本 ， 虽 然 其 中 只 有 一 个 流程 发 生 了 改变 。 





为 了 定制 发 布 方式 ， 你 可 以 为 SpringProcessEngineConfiguration 指定 一 个 额外 的 参数 deploymentMode。 这 个 参数 指定 了 
匹配 多 个 资源 时 的 发 布 处 理 方式 。 黑 认 下 这 个 参数 支持 设置 三 个 值 : 


e default: 把 所 有 资源 放 在 一 个 单独 的 发 布 包 中 ， 对 这 个 发 布 包 进行 重复 检测 。 这 是 默认 值 ， 如 果 你 没有 指定 参数 值 ， 就 
会 使 用 它 。 

e single-resource: 为 每 个 单独 的 资源 创建 一 个 发 布 包 ， 并 对 这 些 发 布 包 进行 重复 检测 。 你 可 以 单独 发 布 每 个 流程 定义 ， 
并 在 修改 流程 定义 后 只 创建 一 个 新 的 流程 定义 版 本 。 

e resource-parent-folder: 把 放 在 同一 个 上 级 目录 下 的 资源 发 布 在 一 个 单独 的 发 布 包 中 ， 并 对 发 布 包 进行 重复 检测 。 当 需 
要 多 资源 需要 创建 发 布 包 ， 但 是 需要 根据 共同 的 文件 夹 来 组 合 一 些 资源 时 ， 可 以 使 用 它 。 


这 儿 有 一 个 例子 来 演示 将 deploymentMode 参数 配置 为 single-resource 的 情况 : 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="deploymentResources" value="classpath*:/activiti/*.bpmn" /> 


<property name="deploymentMode" value="single-resource" /> 
</bean> 


如 果 想 使 用 上 面 三 个 值 之 外 的 参数 值 ， 你 需要 自 定义 处 理发 布 包 的 行为 。 你 可 以 创建 一 个 
SpringProcessEngineConfiguration 的 子 类 ， 重 写 getAutoDeploymentStrategy(String deploymentMode) 方 法 。 这 个 方法 中 
处 理 了 对 应 deploymentMode 的 发 布 策略 
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Unit testing 单元 测试 


当 集 成 Spring 时 ， 使 用 标准 的 Activiti 测试 工具 类 是 非常 容易 的 对 业务 流程 进行 测试 。 下 面 的 例子 展示 了 如 何在 一 个 典型 的 
基于 Spring 单元 测试 测试 业务 流程 : 


@Runwith(SpringJUnit4CLassRunner .class) 
@Contextconfiguration("classpath:org/activiti/spring/test/junit4/springTypicalUsageTest-context.xml") 
public class MyBusinessProcessTest { 


@Autowired 
private RuntimeService runtimeService; 


Q@Autowired 
private TaskService taskService; 


@Autowired 
Q@Rule 
public ActivitiRule activitiSpringRule; 


@Test 

@Deployment 

public void simpleProcessTest() { 
runtimeService.startProcessInstanceByKey("simpleProcess"); 
Task task = taskService.createTaskQuery().singleResult(); 
assertEquals("My Task", task.getName()); 


taskService.complete(task.getId()); 
assertEquals(0, runtimeService.createpProcessInstanceQuery().count()); 


注意 对 于 这 种 方式 ， 你 需要 在 Spring 配置 中 (在 上 文 的 例子 中 它 是 自动 注入 的 ) 定义 一 个 
org.activiti.engine.test.ActivitiRulebean 


<bean id="activitiRule" class="org.activiti.engine.test.ActivitiRule"> 
<property name="processEngine" ref="processEngine" /> 
</bean> 
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Annotation-based configuration 基于 注解 的 配置 


[试验 ] @EnableActiviti 注 解 相 对 较 新 ， 未 来 可 能 会 有 变更 。 


除了 基于 XML 的 配置 以 外 ， 还 可 以 选择 基于 注解 的 方式 来 配置 Spring 环境 。 这 与 使 用 XML 的 方法 非常 相似 ， 除 了 要 使 用 
@Bean 注解 ， 而 且 配 置 是 使 用 java 编写 的 。 它 已 经 可 以 直接 用 于 Activiti-Spring 的 集成 了 : 


首先 介绍 (需要 Spring 3.0+ ) 的 是 @EnableActiviti 注解 。 最 简单 的 用 法 如 下 所 示 : 
@configuration 


@EnableActiviti 
public static class SimplestConfiguration { 


} 


吵 


创建 一 个 Spring 环境 ， 并 对 Activiti 流程 引擎 进行 如 下 配置 


。 默认 的 内 存 H2 数据 库 ， 启 用 数据 库 自动 升级 。 

e 一 个 简单 的 DataSourceTransactionManager 

e 一 个 默认 的 SpringJobExecutor 

e@ 自动 扫描 processes/ 目录 下 的 bpmn20.xml 文件 。 


在 这 样 一 个 环境 里 ， 可 以 直接 通过 注入 操作 Activiti 引擎 : 


@Autowired 
private ProcessEngine processEngine; 


@Autowired 
private RuntimeService runtimeService; 


@Autowired 
private TaskService taskService; 


@Autowired 
private HistoryService historyService ' 


Q@Autowired 
private RepositoryService repositoryService; 


@Autowired 
private ManagementService managementService; 





@Autowired 
private FormService formService; 


当然 ， 默 认 值 都 可 以 自 定 义 。 比 如 ， 如 果 配 置 了 DataSource， 它 就 会 代替 默认 创建 的 数据 库 配 置 。 事务 管理 器 ，job 执行 器 
和 其 他 组 件 都 与 之 相同 。 比如 如 下 配置 : 


Q@configuration 
@EnableActiviti 
public static class Config { 


@Bean 

public DataSource dataSource() { 
BasicDataSource basicDataSource = new BasicDataSource(); 
basicDataSource.setUsername("sa"); 
basicDataSource.setUrl("jdbc:h2:mem:anotherDatabase"); 
basicDataSource.setDefaultAutoCcommit (false); 
basicDataSource.setDriverClassName(org.h2.Driver.class.getName()); 
basicDataSource.setPassword(""); 
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return basicDataSource 


其 他 数据 库 会 代替 默认 的 。 


下 面 介 绍 了 更 加 复杂 的 配置 。 注 意 AbstractActivitiConfigurer 用 法 ， 它 暴露 了 流 


程 


可 以 用 来 对 它 的 细节 进行 详细 的 配置 。 


@Cconfiguration 
@EnableActiviti 


@EnableTransactionManagement (proxyTargetcClass = true) 


class JPAConfiguration 


@Bean 
public OpenJpaVendo 


rAdapter openJpavendorAdapter() { 


OpenJpaVendorAdapter openJpaVendorAdapter = new OpenJpaVendorAdapter(); 
openJpaVendorAdapter .setDatabasePlatform(H2Dictionary.class.getName()); 
return openJpaVendorAdapter; 


@Bean 


public DataSource dataSource() { 


BasicDataSource 


basicDataSource . 


basicDataSource 


basicDataSource = new BasicDataSource(); 
setUsername("sa"); 
.SetUrl("jdbc:h2:mem:activiti"); 
setDefaultAutoCcommit (false); 
.SetDriverClassName(org.h2.Driver.class.getName()); 
setpassword(""); 

aSource; 


erEntityManagerFactoryBean entityManagerFactoryBean( 
apter openJpavendorAdapter，DataSource ds) { 
ntityManagerFactoryBean emf = new LocalContainerEntityManagerFactoryBean(); 


引擎 的 配置 ， 


emf.setPersistenceXmlLocation("classpath:/org/activiti/spring/test/jpa/custom-persistence.xml"); 


basicDataSource . 
basicDataSource 
basicDataSource . 
return basicDat 

@Bean 

public LocalContain 
OpenJpaVendorAd 
LocalContainerE 
emf .setJpaVendo 
emf .SetDataSour 
return emf; 

@Bean 

public PlatformTran 
EntityManagerFa 
return new JpaT 

由 

@Bean 


public AbstractActi 
final EntityMan 
final PlatformT 


return new Abst 


Q@override 


rAdapter(openJpavendorAdapter ); 
ce(ds); 


sactionManager jpaTransactionManager( 
ctory entityManagerFactory) { 
ransactionManager (entityManagerFactory); 


viticonfigurer abstractActivitiConfigurer( 
agerFactory emf, 
ransactionManager transactionManager) { 


ractActiviticonfigurer() { 


public void postProcessSpringProcessEngineConfiguration(SpringProcessEngineConfiguration engine) { 


engine. 
engine. 
engine. 
engine. 
engine. 
engine. 


}; 


// A random bean 

@Bean 

public LoanRequestB 
return new Loan 


setTransactionManager (transactionManager); 
setJpaEntityManagerFactory(emf); 

setJpaHandleTransaction(false); 

setJobExecutorActivate(false); 

setJpaCloseEntityManager (false); 
SetDatabaseSchemaUpdate(ProcessEngineconfiguration.DB_SCHEMA_UPDATE_TRUE ) ， 


ean loanRequestBean() { 
RequestBean(); 
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JPA with Hibernate 4.2.x 


在 Activiti 引 警 的 serviceTask 或 listener 中 使 用 Hibernate 4.2.x JPA 时 ， 需 要 添加 Spring ORM 这 个 额外 的 依赖 。 
Hibernate 4.1.x 及 以 下 版 本 是 不 需要 的 。 应 该 添加 如 下 依赖 : 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-orm</artifactId> 
<version>${org.springframework.version}</version> 
</dependency> 


JPA with Hibernate 4.2.X 
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Business archives 业务 文档 


为 了 部 署 流程 ， 它 们 不 得 不 包装 在 一 个 业务 文档 中 。 一 个 业务 文档 是 Activiti 引擎 部 署 的 单元 。 一 个 业务 文档 相当 与 一 个 压缩 
文件 ， 它 包含 BPMN2.0 流程 ， 任 务 表 单 ， 规 则 和 其 他 任意 类 型 的 文件 。 大 体 上 ， 业 务 文档 是 包含 命名 资源 的 容器 。 


当 一 个 业务 文档 被 部 署 ， 它 将 会 自动 扫描 以 .bpmn20.xml 或 者 .bpmn 作为 扩展 名 的 BPMN 文件 。 每 个 那样 的 文件 都 将 会 被 
解析 并 且 可 能 会 包含 多 个 流程 定义 。 


注意 

业务 归档 中 的 Java 类 将 不 能 够 添加 到 类 路 径 下 。 为 了 能 够 让 流程 运行 ， 必 须 把 存在 于 业务 为 档 程 中 的 流程 定义 使 用 的 所 有 
自 定义 的 类 (例如 : Java 服 务 任务 或 者 实现 事件 的 监听 器 ) 放 在 activiti 引擎 的 类 路 径 下 

Deploying programmatically 编程 式 部 署 

通过 一 个 压缩 文件 部 署 业 务 为 档 ， 它 看 起 来 像 这 样 : 


String barFileName = "path/to/process-one.bar"; 
ZipInputStream inputStream = new ZipInputStream(new FileInputStream(barFileName)); 


repositoryService.createDeployment() 
.Name("process-one.bar") 


.addzipInputStream(inputStream) 
-deploy(); 


它 也 可 以 通过 一 个 独立 资源 构建 部 署 。 详细 信息 请 查看 javadocs。 
Deploying with Activiti Explorer 通过 Activiti Explorer 控制 台 部 署 


Activiti web 控制 台 人 允许 你 通过 web 界面 的 用 户 接口 上 传 一 个 bar 格式 的 压缩 文件 〈 或 者 一 个 bpmn20.xml 格式 的 文件 ) 。 
选择 Management 标签 ,点 击 Deployment: 


© ActivitrExplorer 














Database Deployments Jobs Users Groups 
- Show all | 
时 ACT-cY-9 Uploadnew | 和 


现在 将 会 有 一 个 弹出 窗口 允许 你 从 电脑 上 面 选择 一 个 文件 ， 或 者 你 可 以 简单 的 拖 搜 到 指定 的 区 域 (如 果 你 的 浏览 器 支持 ) 。 
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Upload new deployment 


Select a file (.bar, .zip or .bpmn20.xml) or drop a file in 
the rectangle below. 


Drop a file here 
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External resources 外 部 资源 


流程 定义 保存 在 Activiti 所 支持 的 数据 库 中 。 当 使 用 服务 任务 、 执 行 监听 器 或 者 从 Activiti 配置 文件 中 配置 的 Spring beans 
时 ， 流 程 定义 能 够 引用 这 些 委托 类 。 这 些 类 或 者 Spring 配置 文件 对 于 所 有 流程 引擎 中 可 能 执行 的 流程 定义 必须 是 可 用 的 。 


Java classes 


当 流 程 实例 被 启动 的 时 候 ， 在 流程 中 被 使 用 的 所 有 自 定 义 类 (例如 : 服务 任务 中 使 用 的 JavaDelegates、 事 件 监听 器 、 任 务 
监听 器 ,.….) 应 该 存在 与 流程 引擎 的 类 路 径 下 。 


然后 ， 在 部 署 业务 文档 时 ， 这 些 类 不 必 都 存在 于 类 路 径 下 。 当 使 用 Ant 部 署 一 个 新 的 业务 文档 时 ， 这 意味 着 你 的 委托 关 不 必 
存在 与 类 路 径 下 。 


当 你 使 用 示例 设置 并 添加 你 自 定义 的 类 ， 你 应 该 添加 包含 自 定义 类 的 jar 包 到 activitiexplorer 控制 台 或 者 activiti-rest 的 


webapp lib 文 件 夹 中 。 以 及 不 要 忽略 包含 你 自 定义 类 的 依赖 关系 (如果 有 ) 。 另 外 ， 你 还 可 以 包含 你 自己 的 依赖 添加 到 你 的 
Tomcat 容 器 的 安装 目录 中 的 $ttomcat.homeylib。 


Using Spring beans from a process 在 流程 中 使 用 Spring beans 
当 表 达 式 或 者 脚本 使 用 Spring beans 时 ， 这 些 beans 对 于 引擎 执行 流程 定义 时 必须 是 可 用 的 。 如 果 你 将 要 构建 你 自己 的 
web 应用 并 且 按 照 Spring 集成 这 一 章 中 描述 那样 在 你 的 占用 上 下 文 配置 流程 引擎 ， 这 个 看 上 去 非常 的 简单 。 但 是 要 记 住 ， 如 


果 你 也 在 使 用 Activiti rest web 应 用 ， 那 么 也 应 该 更 新 Activiti rest web 应 用 的 上 下 文 。 你 可 以 把 在 activiti-rest/lib/activiti- 
cfg.jar 文件 中 的 activiti.cfg.xml 替换 成 你 的 Spring 上 下 文 配置 的 activiti-context.xml 文 件 。 


Creating a single app 创建 独立 应 用 


你 可 以 考虑 把 Activiti rest web 应 用 加 入 到 你 的 web 应 用 之 中 ， 因 此 ， 就 仅仅 只 需要 配置 一 个 ProcessEngine， 从 而 不 用 确 
保 所 有 的 流程 引擎 的 所 有 委托 类 在 类 路 径 下 面 并 且 是 否 使 用 正确 的 spring 配置 。 


External resources 外 部 资源 67 

















Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 


Versioning of process definitions 流程 定义 的 版 本 


BPMN 中 并 没有 版 本 的 概念 ， 没 有 版 本 也 是 不 错 的 ， 因 为 可 执行 的 BPMN 流程 作为 你 开发 项 目的 一 部 分 存在 版 本 控制 系统 
的 知识 库 中 (例如 SVN,Git 或 者 Mercurial ) 。 而 在 Activiti 中 ， 流 程 定义 的 版 本 是 在 部 署 时 创建 的 。 在 部 署 的 时 候 ， 流 程 定 
义 被 存储 到 Activiti 使 用 的 数据 库 之 前 ，Activiti 将 会 自动 给 流程 定义 分 配 一 个 版 本 号 。 


对 于 业务 文档 中 每 一 个 的 流程 定义 ， 都 会 通过 下 列 部 署 执行 初始 化 属性 key, version, name 和 id: 





e XML 文件 中 流程 定义 〈 流 程 模型 ) 的 id 属性 被 当做 是 流程 定义 的 key 属 性 。 

e XML 文件 中 的 流程 模型 的 name 属性 被 当做 是 流程 定义 的 name 属性 。 如 果 该 name 属性 并 没有 指定 ， 那 么 id 属性 被 当 
做 是 name。 

e。 带 有 特定 key 的 流程 定义 在 第 一 次 部 署 的 时 候 ， 将 会 自动 分 配 版 本 号 为 1， 对 于 之 后 部 署 相同 key 的 流程 定义 时 候 ， 这 
次 部 署 的 版 本 号 将 会 设置 为 比 当前 最 大 的 版 本 号 大 1 的 值 。 该 key 属性 被 用 来 区 别 不 同 的 流程 定义 。 

e 流程 定义 中 的 id 属性 被 设置 为 {processDefinitionKey}:{processDefinitionVersion}: {generated-id}, 这 里 的 generated-id 
是 一 个 唯一 的 数字 被 添加 ， 用 于 确保 在 集群 环境 中 缓存 的 流程 定义 的 唯一 性 。 








看 下 面 示例 


<definitions id="myDefinitions" > 


<process id="myProcess" name="My important process" > 


当 部 署 了 这 个 流程 定义 之 后 ， 在 数据 库 中 的 流程 定义 看 起 来 像 这 样 : 


Table 6.1. 


id key name version 


myProcess:1:676 myProcess My important process 1 


假设 我 们 现在 部 署 用 一 个 流程 的 最 新 版 本 号 (例如 改变 用 户 任务 ) ， 但 是 流程 定义 的 id 保持 不 变 。 流程 定义 表 将 包含 以 下 
列表 信息 : 


Table 6.2. 
id key name version 
myProcess:1:676 myProcess My important process 1 
myProcess:2:870 myProcess My important process 2 


当 runtimeService.startProcesslnstanceByKey("myProcess'") 方法 被 调用 时 ， 它 将 会 使 用 流程 定义 版 本 号 为 2 的 ， 因 为 这 是 
最 新 版 本 的 流程 定义 。 可 以 说 每 次 流程 定义 创建 流程 实例 时 ， 都 会 默认 使 用 最 新 版 本 的 流程 定义 。 


我 们 应 该 创建 第 二 个 流程 ， 在 Activiti 中 ， 如 下 ,定义 并 且 部 署 它 ， 该 流程 定义 会 添加 到 流程 定义 表 中 


<definitions id="myNewDefinitions" > 
<process id="myNewProcess" name="My important process" > 


表格 如 下 : 
Table 6.3. 
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id 
myProcess:1:676 
myProcess:2:870 


myNewProcess:1:1033 


注意 : 为 何 新 流程 的 key 与 我 们 的 第 一 个 流程 是 不 同 的 。 尽 管 流程 定义 的 名 称 是 相同 的 (当然 








key name 
myProcess My important process 
myProcess My important process 
myNewProcess My important process 


点 的 ) ，Activiti 仅仅 只 考虑 id 属性 判断 流程 。 因 此 ， 新 的 流程 定义 部 署 的 版 本 号 为 1。 
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version 


， 我 们 应 该 也 是 可 以 改变 这 一 
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Providing a process diagram 提供 流程 图 


流程 定义 的 流程 图 可 以 被 添加 到 部 署 中 ， 该 流程 图 将 会 持久 化 到 Activiti 所 使 用 的 数据 库 中 并 且 可 以 通过 Activiti 的 API 进行 
访问 。 该 流程 图 也 可 以 被 用 来 在 Activiti Explorer 控制 台中 的 流程 中 进行 显示 。 如 果 在 我 们 的 类 路 径 下 面 有 一 个 流程 ， 
org/activiti/expenseProcess.bpmn20.xml ， 该 流程 定义 有 一 个 流程 key 'expense'。 以 下 遵循 流程 定义 图 片 的 命名 规范 ( 按 
照 这 个 特地 顺序 ) 


e 如 果 在 部 署 时 一 个 图 片 资 源 已 经 存在 ， 它 是 BPMN2.0 的 XML 文件 名 后 面 是 流程 定义 的 key 并 且 是 一 个 图 片 的 后 级 。 那 
么 该 图 片 将 被 使 用 。 在 我 们 的 例子 中 ， 这 应 该 是 org/activiti/expenseProcess.expense.png (或 者 jpg/gif) 。 如 果 你 在 
一 个 BPMN2.0 XML 文件 中 定义 多 个 流 程 定义 图 片 ， 这 种 方式 更 有 意义 。 每 个 流程 定义 图 片 的 文件 名 中 都 将 会 有 一 个 流 
程 定义 key。 

e 如 果 并 没有 这 样 的 图 片 存 在 ， 部 署 的 时 候 寻找 与 匹配 BPMN2.0 XML 文件 的 名 称 的 图 片 资 源 。 在 我 们 的 例子 中 ， 这 应 该 
是 org/activityexpenseProcess.png. 注意 : 这 意味 着 在 同一 个 BPMN2.0 XML 文件 夹 中 的 每 个 流程 定义 都 会 有 相同 的 流 
程 定义 图 片 。 因 此 ， 在 每 一 个 BPMN 2.0 XML 文件 夹 中 仅仅 只 有 一 个 流程 定义 ， 这 绝对 是 不 会 有 问题 的 。 


当 使 用 编程 式 的 部 署 方式 : 


repositoryService.createDeployment() 
.Name("expense-process.bar") 
.addclasspathResource("org/activiti/expenseProcess.bpmn20.xml") 
.addClasspathResource("org/activiti/expenseProcess.png") 
deploy(); 


接 下 来 ， 可 以 通过 API 来 获取 流程 定义 图 片 资 源 : 


ProcessDefinition processDefinition = repositoryService.createprocessDefinitionQuery() 
.processDefinitionKey("expense") 
.SingleResult(); 


String diagramResourceName = processDefinition.getDiagramResourceName( ); 
InputStream imageStream = repositoryService.getResourceAsStream(processDefinition.getDeploymentId()，diagramResourceh 


了 二 
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Generating a process diagram 生成 流程 图 


擎 竟 会 自动 


在 部 署 时 没有 提供 图 片 的 情况 下 ， 在 上 一 节 中 描述 ,如 果 流 程 定义 中 包含 必要 的 ' 图 像 交 换 ' 信 息 时 ，Activiti 流程 引 
生成 一 个 图 像 。 
该 资源 可 以 按照 部 署 时 提供 流程 图 片 完全 相同 的 方式 获取 。 


dpmndi ;BPMNShape bpmnEtUement "sid-5200C487-F79C-4095-A1A1-1679FAD077C2™ 
td "sid-5200C487-F79C-4095-A1A1-1679FADO77C2 Gul™ 1sExponded “true"> 
© <ongde: dounds height "160,.0" widthe "313,0" x= "930,0" y= "440,.0" /> 
史 </bpandi : BPMNShoape> 
2 <bpmndi :BPMNShape bpmnEtement "sid-SCA62404-2C30-4F92-8830-2374A967E1CE ~ 
[es id-"std-aC462484-2C3D-4F92-883D-2374h967EICE_9ut> 
x& <ongdc: Hounds heightn "30,0" widtho"30.8” x» "960.0" yn "505,0" /> 
Ww </bpandi : BPMNShope> 
NN bpmndi :BPMNShape bpmnEtement- "sid-87E17935-3E0C-49F3-9189-F783CA3E1FFO™ 
2 0 td- "Sid-87E17935-3E0C-49F3-9189-F783CA3EIFFD_ gu "> 
人 <0agdc:Bounds height 80.0”widthn "100.0" xn 1044.8”yr "488.8” /> 
< </bpmndi : BPMNShope> 
<bpmndi :BPMNShope bpmnEtement- Sid-CFOEAC45C-93A4-4EC5-9028-3289007FC3FE™ 


NS d= "sid-CF8AC4SC-9344-4ECS-9028-3289007FCFE_gui "> 
-ndr"Bmamdhe hesnhbn. ”IR MM” wi db "FR OM wm A wn “CHE A /» 


ProcessDefinition 


Object 





Process definition 


如 果 ， 因 为 某 种 原因 ， 在 部 署 的 时 候 ， 并 不 需要 或 者 不 必要 生成 流程 定义 图 片 ， 那 么 就 需要 在 流程 引擎 配置 的 属性 中 使 用 


isCreateDiagramOnDeploy : 


<property name="createDiagramonDeploy" value="false" /> 


现在 图 就 不 会 生成 了 


Generating a process diagram 生成 流程 图 
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Category 类 别 


部 署 和 流程 定义 都 是 用 户 定义 的 类 别 。 流 程 定义 类 别 在 BPMN 文件 中 属性 的 初始 化 的 值 <definitions … 
targetNamespace="yourCategory" … 部 署 类 别 是 可 以 直接 使 用 API 进行 指定 的 看 起 来 想 这 样 : 


repositoryService 
.createDeployment() 
.Category("yourCategory") 


.deploy(); 


Category 类 别 
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What is BPMN 什么 是 BPMN 


见 FAQ 中 关于 BPMN 2.0 部 分 


What is BPMN? 什么 是 BPMN 
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Defining a process 定义 流程 


lk 


注 ; 

文章 假设 你 在 使 用 Eclipse IDE [http://eclipse.org/] 来 创建 和 编辑 文件 。 不 过 ， 其 中 只 用 到 了 Eclipse 很 少 的 特性 。 你 可 以 使 
用 喜欢 的 任何 工具 来 创建 包含 BPMN 2.0 的 xml 文件 。 

创建 一 个 新 的 XML 文件 〈 右 击 任何 项 目 选择 "新建 "->*" 其 他 "->“XML-XML 文 件 ") 并 命名 。 确认 文件 后 级 为 .bpmn20.xml 或 


加 


否则 引擎 无 法 发 布 。 


和 i 
= 


XML 
Create a new XML file. 





Enter or select the parent folder: 
activiti-engine/src/test/resources/org/activiti/examples 


A Gp 
VY Bactiviti 1446 
P Eyengine 1446 
P Lexamples 1444 


P Ey standalone 1425 
E33 FT 
File name: | myProcess.bpmn20.xml 


Advanced >> 


4»( 








® (CC <Back )( Na> ) (cancel ) 9 
用 


BPMN 2.0 根 节点 是 definitions 节点 。 这 个 元 素 中 ， 可 以 定义 多 个 流程 定义 (不 过 我 们 建议 每 个 文件 只 包含 一 个 流程 定义 ， 
可 以 简化 开发 过 程 中 的 维护 难度 ) 。 一 个 空 的 流程 定义 看 起 来 像 下 面 这 样 。 注 意 ，definitions 元 素 最 少 也 要 包含 xmlns 和 
targetNamespace 的 声明 。targetNamespace 可 以 是 任意 值 ， 它 用 来 对 流程 实例 进行 分 类 。 


<definitions 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 


xmlns:activiti="http://activiti.org/bpmn" 
targetNamespace="Examples"> 


<process id="myProcess" name="My First Process"> 


</process> 


</definitions> 


你 也 可 以 选择 添加 线 上 的 BPMN 2.0 格式 位 置 ， 下 面 是 ecilpse 中 的 xml 配置 。 


xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.omg.org/spec/BPMN/20100524/MODEL 
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http:V/www.omg.org/spec/VBPMNV2 .0/20100501/BPMN20 .xsd 





process 元 素 有 两 个 属性 : 








e id : 这 个 属性 是 必须 的 ， 它 对 应 着 Activiti ProcessDefinition 对 象 的 key 属性 。id 可 以 用 来 启动 流程 定义 的 流程 实例 
通过 RuntimeService 的 startProcesslnstanceByKey 方法 。 这 个 方法 会 一 直 使 用 最 新 发 布 版 本 的 流程 定义 ( 译 者 注 : 实际 
中 一 般 都 使 用 这 种 方式 启动 流程 )。 


Processlnstance processlnstance = runtimeService.startProcessInstanceByKey("myProcess"); 


注意 ， 它 和 startProcesslnstanceByld 方法 不 同 。 这 个 方法 期 望 使 用 Activiti 引擎 在 发 布 时 自动 生成 的 id。 可 以 通过 调用 
processDefinition.getld() 方法 获得 这 个 值 。 生成 的 id 的 格式 为 "key:version',， 最 大 长 度 限 制 为 64 个 字符 ， 如 果 你 在 启动 时 
抛 出 了 一 个 ActivitiException， 说 明生 成 的 id 太 长 了 ， 需要 限制 流程 的 key 的 长 度 。 








e name : 这 个 属性 是 可 选 的 ， 对 应 ProcessDefinition 的 name 属性 。 引擎 自己 不 会 使 用 这 个 属性 ， 它 可 以 用 来 在 用 户 接 
口 显示 便于 阅读 的 名 称 。 
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Getting started 10 minute tutorial 快速 开始 -十 分 钟 教程 
这 张 我 们 会 演示 一 个 (非常 简单 ) 的 业务 流程 ， 我 们 会 通过 它 介绍 一 些 基本 的 Activiti 概念 和 APl。 


Prerequisites 前 提 


教程 假设 你 已 经 能 安装 并 运行 Activiti demo， 并 且 你 使 用 了 独立 运行 的 H2 服务 器 。 修 改 db.properties， 设 置 其 中 的 
jdbc.url=jdbc:h2:tcp://localhost/activiti， 然 后 根据 H2 的 文档 启动 独立 服务 器 。 


Goal 目标 
教程 的 目标 是 学 习 Activiti 和 一 些 基本 的 BPMN 2.0 概念 。 最 终结 果 是 一 个 简单 的 Java SE 程序 可 以 发 布 流程 定义 ， 通过 


Activiti 引擎 API 操作 流程 。 我 们 也 会 使 用 一 些 Activiti 相关 的 工具 。 当 然 ， 我 们 在 教程 中 所 学 的 也 可 以 用 于 你 构建 自己 的 业 
务 流程 web 应 用 。 


Use case 用 例 


用 例 很 直接 : 我 们 有 一 个 公司 ， 就 叫 BPMCorp。 在 BPMCorp 中 ， 每 个 月 都 要 给 公司 领导 一 个 金融 报表 。 由 会 计 部 门 负 
责 。 当 报 表 完 成 时 ， 一 个 上 级 领导 需要 审批 文档 ， 然后 才能 发 给 所 有 领导 。 


Process diagram 流程 图 


上 面 描述 的 业务 流程 可 以 用 Activiti Designer 进行 可 视 化 设计 。 然后 ， 为 了 这 个 教程 ， 我 们 会 手工 编写 XML， 这 样 可 以 学 到 
更 多 知识 细节 。 我 们 流程 的 图 形 化 BPMN 2.0 标记 看 起 来 像 这 样 : 












各 


Write monthly 
financial report 


各 


Verify monthly 
financial report 





我 们 看 到 有 空 开始 事件 〈 左 侧 圆圈 ) ， 后 面 是 两 个 用 户 任务 : “制作 月 度 财报 "和 “验证 月 度 财报 "， 最 后 是 空 结束 事件 ( 右 侧 
粗 线 圆 图) 


XML representation 内 容 


业务 流程 的 XML 内 容 (FinancialReportProcess.bpmn20.xml) 如 下 所 示 : 很 容易 找到 流程 的 主要 元 素 (点 击 链 接 可 以 了 解 
BPMN 2.0 结 构 的 详细 信息 ) 


e。 ( 空 ) 开始 事件 是 我 们 流程 的 入 口 。 

e 个 用 户 任务 是 流程 中 与 操作 者 相关 的 任务 声明 。 注意 第 一 个 任务 分 配给 accountancy 组 ， 第 二 个 任务 分 配给 
management 组 。 参考 用 户 任务 分 配 章节 了 解 更 多 关于 用 户 任务 分 配 人 员 和 和 群 组 的 问题 。 

e 当 流 程 达到 空 结束 事件 就 会 结 

e 这 些 元 素 都 使 用 连 线 连接 。 这 些 连 线 拥 有 source 和 target 属性 ， 定义 了 连 线 的 方向 


Write monthly financial report for publication to shareholders. accountancy Verify monthly financial report composed by 
the accountancy department. This financial report is going to be sent to all the company shareholders. management 


Starting a process instance 启动 一 个 流程 实例 
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现在 我 们 创建 好 了 业务 流程 的 流程 定义 。 有 了 这 个 流程 定义 ， 我 们 可 以 创建 流程 实例 了 。 这 时 ， 一 个 流程 实例 对 应 了 特定 月 
度 财报 的 创建 和 审批 。 所 有 流程 实例 都 共享 同一 个 流程 定义 。 


为 了 使 用 流程 定义 创建 流程 实例 ， 首先 要 发 布 业务 流程 ， 这 意味 着 两 方面 : 


e 流程 定义 会 保存 到 持久 化 的 数据 存储 里 ， 是 为 你 的 Activiti 引擎 特别 配置 。 所 以 部 署 好 你 的 业务 流程 ， 我 们 就 能 确认 引 
擎 重启 后 还 能 找到 流程 定义 。 

e BPMN 2.0 流程 文件 会 解析 成 内 存 对 象 模型 ， 可 以 通过 Activiti API 操 作 。 可 以 通过 发 布 章节 获得 关于 发 布 的 更 多 信息 。 
就 像 章节 里 描述 的 一 样 ， 有 很 多 种 方式 可 以 进行 发 布 。 一 种 方式 是 通过 下 面 的 APIl。 注 意 所 有 与 Activiti 引擎 的 交互 都 


是 通过 services。 


Deployment deployment = repositoryService.createDeployment() 


.addClasspathResource("FinancialReportProcess.bpmn20.xml") 
deploy(); 


现在 我 们 可 以 启动 一 个 新 流程 实例 ， 使 用 我 们 定义 在 流程 定义 里 的 id (对 应 XML 文件 中 的 process 元 素 ) 。 注意 这 里 的 id 
对 于 Activiti 来 说 ， 应 该 叫做 key 〈 译 者 注 : 一 般 在 流程 模型 中 使 用 的 ID， 在 Activiti 中 都 是 Key， 上 比如 任务 ID 等 …) 。 


ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("financialReport"); 


这 会 创建 一 个 流程 实例 ， 首 先进 入 开始 事件 。 开始 事件 之 后 ， 它 会 治 着 所 有 的 外 出 连 线 〈 这 里 只 有 一 条 ) 执行 ， 到 达 第 一 个 
任务 〈“ 制 作 月 度 财 报 ") 。 Activiti 会 把 一 个 任务 保存 到 数据 库 里 。 这 时 ， 分 配 到 这 个 任务 的 用 户 或 群 组 会 被 解析 ， 也 会 保存 
到 数据 库 里 。 需要 注意 ，Activiti 引擎 会 继续 执行 流程 的 环节 ， 除 非 遇 到 一 个 等 待 状 态 ， 比 如 用 户 任务 。 在 等 待 状态 下 ， 当 
前 的 流程 实例 的 状态 会 保存 到 数据 库 中 。 直到 用 户 决定 完成 任务 才能 改变 这 个 状态 。 这 时 ， 引 擎 会 继续 执行 ， 直到 遇 到 下 一 
个 等 待 状态 ， 或 流程 结束 。 如 果 中 间 引 擎 重启 或 崩溃 ， 流程 状态 也 会 安全 的 保存 在 数据 库 里 。 


任务 创建 之 后 ，startProcesslnstanceByKey 会 在 到 达 用 户 任 务 这 个 等 待 状态 之 后 才 会 返回 。 这 时 ， 任 务 分 配给 了 一 个 组 ， 
这 意味 着 这 个 组 是 执行 这 个 任务 的 候选 组 。 


我 们 现在 把 所 有 东西 都 放 在 一 起 ， 来 创建 一 个 简单 的 java 程 序 。 创建 一 个 eclipse 项 目 ， 把 Activiti 的 jar 和 依赖 放 到 
classpath 下 。 (这 些 都 可 以 在 Activiti 发 布 包 的 libs 目录 下 找到 ) 。 在 调用 Activiti 服务 之 前 ， 我 们 必须 构造 一 个 
ProcessEngine， 它 可 以 让 我 们 访问 服务 。 这 里 我 们 使 用 ' 单 独 运行 ' 的 配置 ， 这 会 使 用 demo 安装 时 的 数据 库 来 构建 
ProcessEngine。 


你 可 以 在 这 里 下 载 流 程 定义 XML。 这 个 文件 包含 了 上 面 介绍 的 XML， 也 包含 了 必须 的 BPMN 图 像 交 换 信 息 以 便 在 Activiti 
工具 中 能 编辑 流程 。 


public static void main(String[] args) { 


// Create Activiti process engine 

ProcessEngine processEngine = ProcessEngineConfiguration 
.CreatestandaloneProcessEngineConfiguration() 
.buildProcessEngine()， 


// Get Activiti services 
RepositoryService repositoryService = processEngine.getRepositoryService(); 
RuntimeService runtimeService = processEngine.getRuntimeService(); 


// Deploy the process definition 

repositoryService.createDeployment() 
.addclasspathResource("FinancialReportProcess.bpmn20.xml") 
deploy(); 


// Start a process instance 
runtimeService.startProcessInstanceByKey("financialReport"); 
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Task lists 任务 列表 


我 们 现在 可 以 通过 TaskService 来 获得 任务 了 ， 添 加 以 下 逻辑 : 


List<Task> tasks = taskService.createTaskQuery().taskCandidateUser("kermit").1ist(); 
注意 我 们 传 入 的 用 户 必须 是 accountancy 组 的 一 个 成 员 ， 要 和 流程 定义 中 向 对 应 : 


<potentialOwner> 
<resourceAssignmentExpression> 
<formalExpression>accountancy</formalExpression> 
</resourceAssignmentExpression> 
</potentialOwner> 


我 们 也 可 以 使 用 群 组 名 称 ， 通 过 任务 查询 API 来 获得 相关 的 结果 。 现在 可 以 在 代码 中 添加 如 下 逻辑 : 


TaskService taskService = processEngine.getTaskService(); 
List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("accountancy").1ist(); 


因为 我 们 配置 的 ProcessEngine 使 用 了 与 demo 相同 的 数据 ， 我 们 可 以 登录 到 Activiti Explorer。 默认 ，accountancy (会 
计 ) 组 里 没有 任何 人 。 使 用 kermit/kermit 登录 ， 点 击 组 ， 并 创建 一 个 新 组 。 然后 点 击 用 户 ， 把 组 分 配给 fozzie。 现 在 使 用 
fozzie/fozzie 登录 ， 现 在 我 们 就 可 以 启动 我 们 的 业务 流程 了 ， 选择 Processes 页 ， 在 ' 月 度 财 报 ' 的 ' 操 作 ' 列 点 击 ' 启 动 流程 '。 


加 fi 
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My instances Deployed process definitions Model workspace 





Create timers process 


Employee productivity Monthly financial report reminder process 
站 Version 1 © Deployed moments ago 








Fix system failure 





Helpdesk process Process Diagram 
No image available for this process. 








Helpdesk process: firstline vs escalated 


Monthly financial report reminder process 


EE EE 


] 


和 上 面 介 绍 的 那样 ， 流 程 会 执行 到 第 一 个 用 户 任务 。 因 为 我 们 以 kermit 登录 ， 在 启动 流程 实例 之 后 ， 就 可 以 看 到 有 了 一 个 新 
的 待 领 任务 。 选择 任务 页 来 查看 这 条 新 任务 。 注意 即使 流程 被 其 他 人 启动 ， 任 务 还 是 会 被 会 计 组 里 的 所 有 人 作为 一 个 候选 任 
务 看 到 。 


四 [a 
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一 一 一 Accountacy (1) 
( Create new task.. ] Engineering (0) 
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Marketing (0) 
Sales (0) 





Claiming the task 领取 任务 
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现在 一 个 会 计 要 认领 这 个 任务 。 认领 以 后 ， 这 个 用 户 就 会 成 为 任务 的 执行 人 ， 任务 会 从 accountancy 组 的 其 他 成 员 的 任务 
列表 中 消失 。 认领 任务 的 代码 如 下 所 示 : 


taskService.claim(task.getId(), “fozzie")7 


任务 会 进入 认领 任务 人 的 个 人 任务 列表 中 。 


List<Task> tasks = taskService.createTaskQuery().taskAssignee("fozzie").1ist()， 


在 Activiti Explorer UI 中 ， 点 击 认领 按钮 ， 会 执行 相同 的 操作 。 任务 会 移动 到 登录 用 户 的 个 人 任务 列表 。 你 也 会 看 到 任务 的 
执行 人 已 经 变 成 当前 登陆 的 用 户 


四 日 






©> ActivitrExplorer - 


国 Write monthly financial report 国 Write monthly financial report 
| | 国 No due date 三 Medium Priority @@ Created 5 minutes ago 


[eh monthly financial report for publication to shareholders. 


art of process: Monthlyfinancial report reminder process’ 


Reports Manage 


Inbox @ My Tasks 加 Involved 四” Archived 四 











People 


人 No owner (Transfer ) és No assignee 


Subtasks 
No subtasks defined for this task 


Related content 
No related content attached for this task 


Completing the task 完成 任务 


现在 会 计 可 以 开始 进行 财报 的 工作 了 。 报 告 完 成 后 ， 他 可 以 完成 任务 ， 意 味 着 任务 所 需 的 所 有 工作 都 完成 了 


taskService.complete(task.getId()); 


对 于 Activiti 引擎 ， 需 要 一 个 外 部 信息 来 让 流程 实例 继续 执行 。 任务 会 把 自己 从 运行 库 中 删除 。 流程 会 治 着 单独 一 个 外 出 连 
线 执行 ， 移 动 到 第 二 个 任务 〈' 审 批 报告 ) 。 与 第 一 个 任务 相同 的 机 制 会 使 用 到 第 二 个 任务 上 ， 不 同 的 是 任务 是 分 配给 
management 组 。 


在 demo 中 ， 完 成 任务 是 通过 点 击 任务 列表 中 的 完成 按钮 。 因为 Fozzie 不 是 会 计 ， 我 们 先 从 Activiti Explorer 注销 然后 使 用 
kermit 登陆 (他 是 经 理 ) 。 第 二 个 任务 会 进入 未 分 配 任务 列表 。 


Ending the process 结束 流程 
审批 任务 可 以 像 之 前 介绍 的 一 样 查询 和 领取 。 完成 第 二 个 任务 会 让 流程 执行 到 结束 事件 ， 就 会 结束 流程 实例 。 流程 实例 和 所 
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有 相关 的 运行 数据 都 会 从 数据 库 中 删除 。 


登录 Activiti Explorer 就 可 以 进行 验证 ， 可 以 看 到 保存 流程 运行 数据 的 表 中 已 经 没有 数据 了 。 


© ActivitrExplorer 





Database Deployments Active Processes SuspendedProcesses Jobs Users Groups Administration 


VVC 


电 AcTip_usER (3) 
ACT_RE_DEPLOYMENT (3) ACT_RU_EXECUTION 


ACT_RE_MODEL (1) 
Table contains no rows 
ACT_RE_PROCDEF (11) 
ACT_RU_EVENT_SUBSCR (0) 
ACT_RU_EXECUTION (0) 
ACT_RU_IDENTITYLINK (0) 


ACT_RU_JOB (0) 


ACT_RU_TASK (0) 


OE OE EE Wad 


ACT_RU_VARIABLE (0) 


通过 程序 ， 你 也 可 以 使 用 historyService 判断 流程 已 经 结束 了 。 


HistoryService historyService = processEngine.getHistoryService() 

HistoricProcessInstance historicProcessInstance = 
historyService.createHistoricProcessInstanceQuery().processInstanceId(procId).singlLleResult()， 
System.out.println("Process instance end time: " + historicProcessInstance.getEndTime( ) )， 


Code overview 代码 总 结 


把 上 述 代码 组 合 在 一 起 ， 获 得 的 代码 如 下 所 示 (这 些 代码 考虑 到 你 可 能 会 在 Activiti Explorer UI 中 启动 一 些 流程 实例 。 这 
样 ， 它 会 获得 多 个 任务 ， 而 不 是 一 个 ， 所 以 代码 可 以 一 直 正 常 运行 ) 


public class TenMinuteTutorial { 
public static void main(String[] args) { 


// Create Activiti process engine 

ProcessEngine processEngine = ProcessEngineConfiguration 
.CreatestandaloneProcessEngineConfiguration() 
.buildProcessEngine(); 


// Get Activiti services 
RepositoryService repositoryService = processEngine.getRepositoryService(); 
RuntimeService runtimeService = processEngine.getRuntimeService(); 


// Deploy the process definition 

repositoryService.createDeployment() 
.addClasspathResource("FinancialReportProcess.bpmn20.xml") 
.deploy(); 


// Start a process instance 
String procId = runtimeService.startProcessInstanceByKey("financialReport").getId(); 


/7/ Get the first task 
TaskService taskService = processEngine.getTaskService(); 
List<Task> tasks = taskService.createTaskQuery().taskcandidateGroup("accountancy").1ist(); 
For (Task task : tasks) LT 
System.out.println("Following task is available for accountancy group: " + task.getName()); 


// claim it 
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taskService.claim(task.getId(), "fozzie"); 


} 


// Verify Fozzie can now retrieve the task 
tasks = taskService.createTaskQuery().taskAssignee("fozzie").1ist(); 
for (Task task : tasks) { 

System.out.printin("Task for fozzie: " + task.getName\()) 


// Complete the task 
taskService.complete(task.getId()); 
yD 


System.out.println("Number of tasks for fozzie: " 
+ taskService.createTaskQuery().taskAssignee("fozzie").count()); 


// Retrieve and claim the second task 

tasks = taskService.createTaskQuery().taskCcandidateGroup("management").1ist(); 

for (Task task tasks) { 
System.out.println("Following task is available for accountancy group: " + task.getName()); 
taskService.claim(task.getId(), "kermit"); 


» 


// Completing the second task ends the process 

for (Task task : tasks) { 
taskService.complete(task.getId()); 

上 


// verify that the process is actually finished 

HistoryService historyService = processEngine.getHistoryService(); 

HistoricProcessInstance historicProcessInstance = 
historyService.createHistoricProcessInstanceQuery().processInstanceId(procId).singleResult()， 

System.out.println("Process instance end time: " + historicProcessInstance.getEndTime( ) )， 


这 段 代 码 包含 在 实例 中 的 一 个 单元 测试 中 〈 是 的 ， 你 可 以 运行 单元 测试 来 测试 你 的 流程 。 参考 单元 测试 章节 来 了 解 更 多 信 
息 ) 


Future enhancements 未 来 的 增强 


可 以 看 到 业务 流程 相对 于 现实 来 说 太 简 单 了 。 然而 ， 你 可 以 了 解 Activiti 中 的 BPMN 2.0 结构 ， 你 可 以 考虑 对 业务 流程 进行 
以 下 方面 的 加 强 : 


e 定义 网 关 来 实现 决策 环节 。 这 样 ， 经 理 可 以 驱 回 财报， 重新 给 会 计 创 建 一 个 任务 。 
@ 考虑 使 用 变量 ， 这 样 我 们 可 以 保存 或 引用 报告 ， 把 它 显示 到 表单 中 。 

e 在 流程 最 后 加 入 服务 任务 ， 把 报告 发 给 每 个 领导 。 

e 其 它 
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Chapter 8. BPMN 2.0 Constructs 关于 BPMN 2.0 架构 


本 章 介绍 Activiti 支持 的 BPMN 2.0 结构 ， 以 及 对 BPMN 标准 的 扩展 。 
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Custom extensions 自 定 义 扩 展 


BPMN 2.0 标准 对 于 各 方 都 是 一 个 好 东西 。 最 终 用 户 不 用 担心 会 绑 死 在 供应 商 提供 的 专 有 解决 方案 上 。 框架 ， 特 别 是 Activiti 
这 样 的 开源 框架 ， 可 以 提供 相同 功能 (其 至 是 更 好 的 实现 ) ， 足 以 和 大 的 供应 商 姬 美 。 按照 BPMN 2.0 标准 ， 从 大 供应 商 的 
解决 方案 迁移 到 Activiti 只 会 经 过 一 个 简单 而 平滑 的 过 程 。 


标准 不 好 的 一 点 是 ， 它 常常 是 不 同 公司 之 间 大 量 讨论 和 妥协 的 结果 。 (而且 通常 是 愿景 ) 。 作 为 开发 者 去 阅读 流程 定义 的 
BPMN 2.0 XML 时 ， 有 时 会 感觉 用 这 种 结构 和 方法 去 做 事 太 麻烦 了 。 因此 Activiti 把 简化 开发 作为 最 优先 的 事情 ， 我 们 会 使 
用 一 些 被 称 为 'Activiti BPMN 扩展 ' 的 功能 。 这 些 扩展 是 新 的 结构 或 方法 来 简化 对 应 的 结构 ， 它 们 并 不 属于 BPMN 2.0 规范 。 


虽然 BPMN 2.0 规范 清楚 的 指明 了 如 何 开发 自 定义 扩展 ， 但 是 我 们 还 要 确认 一 下 几 点 : 


e 自 定义 扩展 的 前 提 是 总 有 简单 的 方法 转换 成 标准 方法 。 所 以 当 你 决定 使 用 自 定 义 扩 展 时 ， 不 用 担心 没 办 法 回头 。 
e@ 当 使 用 自 定义 扩展 时 ， 总 会 清楚 的 指明 使 用 了 新 的 XML 元 素 ， 属 性 ， 等 等 。 比如 会 使 用 activiti: 命名 空间 前 级 。 
e 这 些 扩 展 的 目标 是 最 终 把 它们 加 入 到 下 一 版 本 的 BPMN 规范 中 ， 或 者 至 少 可 以 引起 对 特定 BPMN 结构 的 讨论 。 


因此 无 论 是 是 否 想 要 使 用 自 定义 扩展 ， 这 都 取决 于 你 。 很 多 因素 会 影响 决定 这 个 决定 (图形 编辑 器 ， 公 司 策略 ， 等 等 ) 。 只 
是 因为 我 们 相信 标准 里 的 一 些 功 能 可 以 更 简单 或 更 高 效 ， 所 以 才 决 定 提供 自 定义 扩展 。 请 对 扩展 给 予 我 们 (正面 或 负面 ) 的 
评价 ， 或 者 是 对 自 定义 扩展 的 心 想法 。 说 不 定 有 一 天 你 的 想法 就 会 加 入 到 规范 中 
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Events 事件 


事件 用 来 表明 流程 的 生命 周期 中 发 生 了 什么 事 。 事件 总 是 画 成 一 个 圆圈 。 在 BPMN 2.0 中 ， 事 件 有 两 大 分 类 : 捕获 
(catching) 或 触发 (throwing) 事件 。 


。 捕获 (Catching) : 当 流 程 执 行 到 事件 ， 它 会 等 待 被 触发 。 触 发 的 类 型 是 由 内 部 图 表 或 XML 中 的 类 型 声明 来 决定 的 。 
捕获 事件 与 触发 事件 在 显示 方面 是 根据 内 部 图 表 是 否 被 填充 来 区 分 的 〈 白 色 的 ) 。 


。 触发 (Throwing) : 当 流 程 执行 到 事件 ， 会 触发 一 个 事件 。 触 发 的 类 型 是 由 内 部 图 表 或 XML 中 的 类 型 声明 来 决定 的 。 
触发 事件 与 捕获 事件 在 显示 方面 是 根据 内 部 图 表 是 否 被 填充 来 区 分 的 (被 填充 为 黑色 ) 。 


Event Definitions 事件 定义 
事件 定义 决定 了 事件 的 语义 。 如 果 没 有 事件 定义 ， 这 个 事件 就 不 做 什么 特别 的 事情 。 没有 设置 事件 定义 的 开始 事件 不 会 在 


动 流程 时 做 任何 事情 。 如 果 给 开始 事件 添加 了 一 个 事件 定义 〈 比 如 定时 器 事件 定义 ) 我 们 就 声明 了 开始 流程 的 事件 "类型" 
(这 时 定时 器 事件 监听 器 会 在 某 个 时 间 被 触发 ) 。 


Timer Event Definitions 定时 器 事件 定义 
定时 器 事件 是 根据 指定 的 时 间 触 发 的 事件 。 可 以 用 于 开始 事件 ， 中 间 事 件 或 边界 事件 。 
定时 器 定义 必须 包含 下 面 介绍 的 一 个 元 素 : 

e timeDate。 使 用 ISO 8601 格式 指定 一 个 确定 的 时 间 ， 触 发 事件 的 时 间 。 示 例 : 


2011-03-11T12:13:14 
e timeDuration。 指 定 定时 器 之 前 要 等 待 多 长 时 间 ，timeDuration 可 以 设置 为 timerEventDefinition 的 子 元 素 。 使 用 ISO 
8601 规定 的 格式 (由 BPMN 2.0 规定 ) 。 示 例 (等 待 10 天 ) 。 


P10D 


启 


e timeCycle。 指 定 重复 执行 的 间隔 ， 可 以 用 来 定期 启动 流程 实例 ， 或 为 超时 时 间 发 送 多 个 提醒 。 timeCycl e 元 素 可 以 使 用 





两 种 格式 。 第 一 种 是 ISO 8601 标准 的 格式 。 示 例 (重复 3 次 ， 每 次 间隔 10 小 时 ) 
R3/PT10H 


另外 ， 你 可 以 使 用 cron 表达 式 指定 timeCycle， 下 面 的 例子 是 从 整 点 开始 ， 每 5 分 钟 执 行 一 次 : 


(0) MoVASy et 


请 参考 cron 表达 式 教程 来 了 解 如 何 使 用 


注意 : 第 一 个 数字 表示 秒 ， 而 不 是 像 通常 Unix cron 中 那样 表示 分 钟 。 重复 的 时 间 周 期 能 更 好 的 处 理 相对 时 间 ， 它 可 以 计算 


一 些 特定 的 时 间 点 (比如 ， 用 户 任务 的 开始 时 间 ) ， 而 cron 表达 式 可 以 处 理 绝对 时 间 - 这 对 定时 开始 事件 特别 有 用 。 


你 可 以 在 定时 器 事件 定义 中 使 用 表达 式 ， 这 样 你 就 可 以 通过 流程 变量 来 影响 那个 定时 器 定义 。 流程 定义 必须 包含 ISO 
8601 (或 cron) 格式 的 字符 串 ， 以 匹配 对 应 的 时 间 类 型 。 


<boundaryEvent id="escalationTimer" cancelActivity="true" attachedToRef="firstLineSupport"> 
<timerEventDefinition> 
<timeDuration>${duration}</timeDuration> 
</timerEventDefinition> 
</boundaryEvent> 
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注意 : 只 有 启用 job 执行 器 之 后 ， 定 时 器 才 会 被 触发 。 (activiti.cfg.xml 中 的 jobExecutorActivate 需要 设置 为 rue， 不 
过 ， 默 认 job 执行 器 是 关闭 的 ) 。 


Error Event Definitions 错误 事件 定义 

错误 事件 是 由 指定 错误 触发 的 。 

重要 提醒 : BPMN 错误 与 Java 异常 完全 不 一 样 。 实际 上 ， 他 俩 一 点 儿 共 同 点 都 没有 。BPMN 错误 事件 是 为 了 对 业务 异常 建 
模 。Java 异常 是 要 用 特定 方式 处 理 。 


错误 事件 定义 会 引用 一 个 error 元 素 。 下 面 是 一 个 error 元 素 的 例子 ， 引 用 了 一 个 错误 声明 : 


<endEvent id="myErrorEndEvent"> 
<errorEventDefinition errorRef="myError" /> 
</endEvent> 


引用 相同 error 元 素 的 错误 事件 处 理 器 会 捕获 这 个 错误 。 


Signal Event Definitions 信号 事件 定义 
信号 事件 会 引用 一 个 已 命名 的 信号 。 信 号 全 局 范围 的 事件 (广播 语义 ) 。 会 发 送 给 所 有 激活 的 处 理 器 。 


信号 事件 定义 使 用 signalEventDefinition 元 素 。 signalRef 属性 会 引用 definitions 根 节点 里 定义 的 signal 子 元 素 。 下 面 是 一 
个 流程 的 实例 ， 其 中 会 抛 出 一 个 信号 ， 并 被 中 间 事 件 捕获 。 


<definitions... > 
<!-- declaration of the signal --> 
<signal id="alertSignal" name="alert" /> 


<process id="catchSignal"> 
<intermediateThrowEvent id="throwSignalEvent" name="Alert"> 
<!-- signal event definition --> 
<signalEventDefinition signalRef="alertSignal" /> 
</intermediateThrowEvent> 


<intermediateCatchEvent id="catchSignalEvent" name="On Alert"> 
<!-- signal event definition --> 
<signalEventDefinition signalRef="alertSignal" /> 


</intermediateCatchEvent> 


</process> 
</definitions> 


signalEventDefinition 引用 相同 的 signal 元 素 。 


Throwing a Signal Event 触发 信号 事件 


既 可 以 通过 bpmn 节点 由 流程 实例 触发 一 个 信号 ， 也 可 以 通过 API 触发 。 下 面 的 org.activiti.engine.RuntimeService 中 的 方 
法 可 以 用 来 手工 触发 一 个 信号 。 


RuntimeService.signalEventReceived(String signalName); 
RuntimeService.signalEventReceived(String signalName, String executionId); 


signalEventReceived(String signalName); 和 signalEventReceived(String signalName, String executionld); 之 间 的 区 别 是 第 
一 个 方法 会 把 信号 发 送 给 全 局 所 有 订阅 的 处 理 器 (广播 语义 ) ， 第 二 个 方法 只 把 信息 发 送 给 指定 的 执行 。 
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Catching a Signal Event 捕获 信号 事件 
信号 事件 可 以 被 中 间 捕 获 信号 事件 或 边界 信息 事件 捕获 。 
Querying for Signal Event subscriptions 查询 信号 事件 的 订阅 


可 以 查询 所 有 订阅 了 特定 信号 事件 的 执行 : 


List<Execution> executions = runtimeService.createExecutionQuery() 
.SignalEventSubscriptionName("alert") 
is 全 局 


我 们 可 以 使 用 signalEventReceived(String signalName, String executionld) 方法 把 信号 发 送 给 这 些 执行 。 


Signal event scope 信号 事件 范围 


默认 ， 信 号 会 在 流程 引擎 范围 内 进行 广播 。 就 是 说 ， 你 可 以 在 一 个 流程 实例 中 抛 出 一 个 信号 事件 ， 其 他 不 同 流程 定义 的 流程 
实例 都 可 以 监听 到 这 个 事件 。 


然而 ， 有 时 只 希望 在 同一 个 流程 实例 中 响应 这 个 信号 事件 。 比如 一 个 场景 是 ， 流 程 实例 中 的 同步 机 制 ， 如 果 两 个 或 更 多 活动 
是 互 斥 的 。 


如 果 想 要 限制 信号 事件 的 范围 ， 可 以 使 用 信号 事件 定义 的 scope 属性 (不 是 BPMN2.0 的 标准 属性 ) 
<signal id="alertSignal" name="alert" activiti:scope="processInstance"/> 


这 个 属性 值 默 认 是 "global" 


Signal Event example(s) 信号 事件 实例 


下 面 是 两 个 不 同 流程 使 用 信号 交互 的 例子 。 第 一 个 流程 在 保险 规则 更 新 或 改变 时 启动 。 在 修改 被 参与 者 处 理 时 ， 会 触发 一 个 
信息 ， 通 知 规则 改变 : 


approved? 









approve new 


PoOIICY 
conditions 











policy policy 
Di ond 
updated changed 


这 个 时 间 会 被 所 有 感 兴趣 的 流程 实例 捕获 。 下 面 是 一 个 订阅 这 个 事件 的 流程 实例 。 
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manual _ 
post-processing 
necessary? 












calculate 
contract send contract 
conditions document 


. new 
insurance 
application received 









adjust 
contract 
manually 






Dolicy 
conditions 
changed 


注意 : 要 了 解 信号 事件 是 广播 给 所 有 激活 的 处 理 器 的 。 这 意味 着 在 上 面 的 例子 中 ， 所 有 流程 实例 都 会 接收 到 这 个 事件 。 这 就 
是 我 们 想 要 的 。 然 而 ， 有 的 情况 下 并 不 想 要 这 种 广播 行为 。 考虑 下 面 的 流程 







do something 


do something 
in parallel 






perform 
escalation 


上 述 流程 描述 的 模式 activiti 并 不 支持 。 这 种 想法 是 执行 “do something" 任 务 时 出 现 的 错误 ， 会 被 边界 错误 事件 捕获 ， 然 后 使 
用 信号 传播 给 并 发 路 径 上 的 分 支 ， 进 而 中 断 "do something inparallel" 任 务 。 目前 ，activiti 实际 运行 的 结果 与 期 望 一 致 。 信 号 
会 传播 给 边界 事件 并 中 断 任务 。 但 是 ， 根 据 信号 的 广播 含义 ， 它 也 会 传播 给 所 有 其 他 订阅 了 信号 事件 的 流程 实例 。 所 以 ， 这 
就 不 是 我 们 想 要 的 结果 。 


注意 : 信号 事件 不 会 执行 任何 与 特定 流程 实例 的 联系 。 如 果 你 只 想 把 一 个 信息 发 给 指定 的 流程 实例 ， 需 要 手工 关联 ， 再 使 用 
signalEventReceived(String signalName, String executionld) 和 对 应 的 查询 机 制 。 


Message Event Definitions 消息 事件 定义 





消息 事件 的 事件 消息 引用 命名 。 一 个 消息 有 一 个 名 字 和 一 个 有 效 载 荷 。 不 像 一 个 信号 ， 一 个 消息 事件 总 是 指向 一 个 接收 器 。 


一 个 消息 事件 的 定义 是 使 用 messageeventdefinition 元 素 声 明 。 属 性 messageref 引用 一 个 消息 元 素 声 明 为 定义 的 根 元 素 的 子 
元 素 。 以 下 是 摘录 的 一 个 过 程 ， 其 中 两 个 消息 事件 声明 的 开始 事件 和 中 间 捕 捉 事 件 消 息 引用 。 
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<definitions id="definitions" 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 
xmlns:activiti="http://activiti.org/bpmn" 
targetNamespace="Examples" 
xmlns:tns="Examples"> 


<message id="newInvoice" name="newInvoiceMessage" /> 
<message id="payment" name="paymentMessage" /> 


<process id="invoiceProcess"> 
<startEvent id="messageStart" > 
<messageEventDefinition messageRef="newInvoice" /> 
</startEvent> 
<intermediateCatchEvent id="paymentEvt" > 
<messageEventDefinition messageRef="payment" /> 
</intermediateCcatchEvent> 
</process> 


</definitions> 


Throwing a Message Event 触发 消息 事件 


作为 一 个 戏 入 式 的 流程 引擎 ，activit i 不 能 真正 接收 一 个 消息 。 这 些 环境 相关 ， 与 平台 相关 的 活动 比如 连接 到 JMS (Java 消 
息 服务 ) 队列 或 主题 或 执行 WebService 或 REST 请 的 这 个 消息 的 接收 是 你 要 在 应 用 或 架构 的 一 层 实 现 的 ， 流 程 引擎 则 内 
刻 其 中 。 


在 你 的 应 用 接收 一 个 消息 之 后 ， 你 必须 决定 如 何 处 理 它 。 如 果 消 息 应 该 触发 启动 一 个 新 流程 实例 ， 在 下 面 的 
RuntimeService Wg py te : 


ProcessInstance startProcessInstanceByMessage(String messageName); 
ProcessInstance startProcessInstanceByMessage(String messageName, Map<String, Object> processVariables); 
ProcessInstance startProcessInstanceByMessage(String messageName, String businessKey, Map<String, Object> processVariat 


.4 Es E 
这 些 方 法 允许 使 用 对 应 的 消息 系统 流程 实例 。 








如 果 消 息 需 要 被 运行 中 的 流程 实例 处 理 ， 首 先 要 根据 消息 找到 对 应 的 流程 实例 (参考 下 一 节 ) 然后 触发 这 个 等 待 中 的 流程 。 
RuntimeService 提供 了 如 下 方法 可 以 基于 消息 事件 的 订阅 来 触发 流程 继续 执行 


void messageEventReceived(String messageName, String executionId); 
void messageEventReceived(String messageName, String executionId, HashMap<String, Object> processVariables); 


Querying for Message Event subscriptions 查询 消息 事件 的 订阅 


Activiti 支持 消息 开始 事件 和 中 间 消 息 事 件 。 





e 消息 开始 事件 的 情况 ， 消 息 事 件 订 阅 分 配给 一 个 特定 的 process definition 。 这 个 消息 订阅 可 以 使 用 
ProcessDefinitionQuery 查询 到 : 


ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery() 


.messageEventSubscription("newCallCenterBooking") 
.SingleResult(); 
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因为 同时 只 能 有 一 个 流程 定义 关联 到 消息 的 订阅 点 ， 查 询 总 是 返回 0 或 一 个 结果 。 如 果 流 程 定义 更 新 了 ， 那么 只 有 最 新 版 本 
的 流程 定义 会 订 阅 到 消 息 事 件 上 。 


。 中 间 捕 获 消息 事件 的 情况 ， 消 息 事 件 订 阅 会 分 配给 特定 的 执行 。 这 个 消息 事件 订阅 可 以 使 用 ExecutionQuery 查询 到 : 


Execution execution = runtimeService.createExecutionQuery() 


.messageEventSubscriptionName("paymentReceived") 
.variableValueEquals("orderId", message.getorderId()) 
.SingleResult(); 


这 个 查询 可 以 调用 对 应 的 查询 ， 通 常 是 流程 相关 的 信息 (这 里 ， 最 多 只 能 有 一 个 流程 实例 对 应 着 orderld ) 。 


Message Event example(s) 消息 事件 实例 


下 面 是 一 个 使 用 两 个 不 同 消息 启动 的 流程 实例 : 











new call center 
order received 


fulfill order 





名 


post process 
manually 






new web shop 
order received 


可 以 用 在 ， 流 程 需要 不 同 的 方式 来 区 分 开始 事件 ， 而 后 最 终 会 进入 同样 的 路 径 。 


Start Events 开始 事件 


开始 事件 用 来 指明 流程 在 哪里 开始 。 开 始 事件 的 类 型 (流程 在 接收 事件 时 局 动 ， 还 是 在 指定 时 间 启动 ， 等 等 ) ， 定 义 了 流程 
如 何 启 动 ， 这 通过 事件 中 不 同 的 小 图 表 来 展示 。 在 XML 中 ， 这 些 类 型 是 通过 声明 不 同 的 子 元 素来 区 分 的 。 


开始 事件 都 是 捕获 事件 : 最 终 这 些 事件 都 是 (一直) 等 待 着 ， 直 到 对 应 的 触发 时 机 出 现 。 
在 开始 事件 中 ， 可 以 设置 下 面 的 activiti 特定 属性 : 
e initiator : 当 流 程 启动 时 ， 把 当前 登录 的 用 户 保存 到 哪个 变量 名 中 。 示例 如 下 : 


登录 的 用 户 必须 使 用 IdentityService.setAuthenticatedUserld(String) 方法 设置 ， 并 像 这 样 包含 在 try-finally 代码 中 : 


上 TY 
identityService.setAuthenticatedUserId("bono"); 
runtimeService.startProcessInstanceByKey("someProcessKey"); 
} finally { 
identityService.setAuthenticatedUserId(null); 


} 


这 段 代码 来 自 Activiti Explorer， 所 以 它 可 以 和 Chapter 9. Forms 表单 一 起 结合 使 用 。 
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None Start Event 空 开始 事件 


Description 描述 


空 开始 事件 技术 上 意味 着 没有 指定 启动 流程 实例 的 触发 条 件 。 这 就 是 说 引擎 不 能 预计 什么 时 候 流程 实例 会 自动。 空 开 始 事 件 
用 于 ， 当 流程 实例 要 通过 API 启动 的 场景 ， 通过 调用 startProcesslnstanceByXXX 方法 。 


ProcessInstance processInstance = runtimeService.startProcessInstanceByXXX() 
< : 
注意 : 子 流程 都 有 一 个 空 开 始 事 件 。 


Graphical notation 图 形 标记 


空 开 始 事 件 显 示 成 一 个 圆圈 ， 没 有 内 部 图 表 (没有 触发 类 型 ) 


em 


XML representation 内 容 


空 开 始 事件 的 XML 结构 是 普通 的 开始 事件 定义 ， 没 有 任何 子 元 素 〈 其 他 开始 事件 类 型 都 有 一 个 子 元 素来 声明 自己 的 类 型 ) 


<startEvent id="start" name="my start event" /> 


Custom extensions for the none start event 空 开 始 事 件 的 自 定义 扩展 


formKey : 引用 用 户 在 启动 新 流程 实例 时 需要 填写 的 表单 模板 ， 更 多 信息 可 以 参考 Chapter 9. Forms 表单 。 实例 : 


<startEvent id="request" activiti:formKey="org/activiti/examples/taskforms/request.form" /> 


Timer Start Event 定时 开始 事件 
Description 描述 
定时 开始 事件 用 来 在 指定 的 时 间 创 建 流程 实例 。 它 可 以 同时 用 于 只 启动 一 次 的 流程 和 应 该 在 特定 时 间 间 隔 启 动 多 次 的 流程 。 


注意 : 子 流程 不 能 使 用 定时 开始 事件 。 


囊 


注意 : 定时 开始 事件 在 流程 发 布 后 就 会 开始 计算 时 间 。 不 需要 调用 startProcesslnstanceByXXX ， 哩 然 也 而 已 调用 启动 流程 
的 方法 ， 但 是 那 会 导致 调用 startProcesslnstanceByXXX 时 启动 过 多 的 流程 。 


注意 : 当 包含 定时 开始 事件 的 新 版 本 流程 部 署 时 ， 对 应 的 上 一 个 定时 器 就 会 被 删除 。 这 是 因为 通常 不 希望 自动 启动 旧版 本 流 
程 的 流程 实例 。 


Graphical notation 图 形 标记 
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定时 开始 事件 显示 为 了 一 个 回 圈 ， 内 部 是 一 个 表 。 


XML representation 内 容 


定时 开始 事件 的 XML 内 容 是 普通 开始 事件 的 声明 ， 包 含 一 个 定时 定义 子 元 素 。 请 参考 Timer Event Definitions 定时 器 事件 定 
义 查看 配合 细节 。 


示例 : 流程 会 启动 4 次 ， 每 次 间隔 5 分 钟 ， 从 2011 年 3 月 11 日 ，12:13 开 始 计时 。 


<startEvent id="thestart"> 
<timerEventDefinition> 
<timeCycle>R4/2011-03-11T12:13/PT5M</timeCycle> 
</timerEventDefinition> 
</startEvent> 


示例 : 流程 会 根据 选中 的 时 间 启动 一 次 。 


<startEvent id="thestart"> 
<timerEventDefinition> 
<timeDate>2011-03-11T12:13:14</timeDate> 
</timerEventDefinition> 
</startEvent> 


Message Start Event 


Description 描述 





消息 开始 事件 可 以 用 其 使 用 一 个 命名 的 消息 来 启动 流程 实例 。 这 样 可 以 帮助 我 们 使 用 消息 名 称 来 选择 正确 的 开始 事件 。 


在 发 布 包含 一 个 或 多 个 消息 开始 事件 的 流程 定义 时 ， 需 要 考虑 下 面 的 条 件 : 





e 消息 开始 事件 的 名 称 在 给 定 流程 定义 中 不 能 重复 。 流 程 定义 不 能 包含 多 个 名 称 相同 的 消息 开始 事件 。 如 果 两 个 或 以 上 消 
息 开始 事件 应 用 了 相同 的 事件 ， 或 两 个 或 以 上 消息 事件 引用 的 消息 名 称 相同 ，activiti 会 在 发 布 流 程 定义 时 抛 出 异常 。 

。 消息 开始 事件 的 名 称 在 所 有 已 发 布 的 流程 定义 中 不 能 重复 。 如 果 一 个 或 多 个 消息 开始 事件 引用 了 相同 名 称 的 消息 ， 而 这 
个 消息 开始 事件 已 经 部 署 到 不 同 的 流程 定义 中 ， activiti 就 会 在 发 布 时 抛 出 一 个 异常 。 

e 流程 版 本 : 在 发 布 新 版 本 的 流程 定义 时 ， 之 前 订阅 的 消息 订阅 会 被 取消 。 如 果 新 版 本 中 没有 消息 事件 也 会 这 样 处 理 。 





Ey 


动 流程 实例 ， 消 息 开始 事件 可 以 使 用 下 列 RuntimeService 中 的 方法 来 触发 : 


ProcessInstance startProcessInstanceByMessage(String messageName); 
ProcessInstance startProcessInstanceByMessage(String messageName, Map<String, Object> processVariables); 
ProcessInstance startProcessInstanceByMessage(String messageName, String businesskey, Map<String, Object< processVariat 


MN” 了 一 一 了 


这 里 的 messageName 是 messageEventDefinition 的 messageRef 属性 引用 的 message 元 素 的 name 属性 。 启动 流程 实 
例 时 ， 要 考虑 一 下 因素 : 





e 消息 开始 事件 只 支持 项 级 流程 。 消 息 开始 事件 不 支持 内 绕 子 流程 。 
e 如 果 流 程 定义 有 多 个 消息 开始 事件 ，runtimeService.startProcesslnstanceByMessage(...) 会 选择 对 应 的 开始 事件 。 
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e 如 果 流 程 定义 有 多 个 消息 开始 事件 和 一 个 空 开始 事件 。 runtimeService.startProcesslnstanceByKey(.…) 和 


runtimeService.startProcesslnstanceByld(...) 会 使 用 空 开 始 事件 启动 流程 实例 。 


e 如 果 流 程 定义 有 多 个 消息 开始 事件 ， 而 且 没有 空 开 始 事件 ， runtimeService.startProcesslnstanceByKey(…) 和 


runtimeService.startProcesslnstanceByld(.…) 会 抛 出 异常 。 

e 如 果 流 程 定义 只 有 一 个 消息 开始 事件 ， runtimeService.startProcesslnstanceByKey(.…) 和 
runtimeService.startProcesslnstanceByld(...) 会 使 用 这 个 消息 开始 事件 启动 流程 实例 。 

e 如 果 流 程 被 调用 环节 (callActivity) 启动 ， 消 息 开始 事件 只 支持 如 下 情况 : 

e 在 消息 开始 事件 以 外 ， 还 有 一 个 单独 的 空 开 始 事件 

e 流程 只 有 一 个 消息 开始 事件 ， 没 有 空 开 始 事件 。 





Graphical notation 图 形 标记 


消息 开始 事件 是 一 个 圆圈 ， 中 间 是 一 个 消息 事件 图 标 。 图 标 是 白色 未 填充 的 ， 来 表示 捕获 (接收 ) 行为 。 





new web shop 
order recelved 


XML representation 内 容 





消息 开始 事件 的 XML 内 容 时 在 普通 开始 事件 申请 中 包含 一 个 messageEventDefinition 子 元 素 : 


<definitions id="definitions" 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 
xmlns:activiti="http://activiti.org/bpmn" 
targetNamespace="Examples" 
xmlns:tns="Examples"> 
<message id="newInvoice" name="newInvoiceMessage" /> 
<process id="invoiceProcess"> 
<startEvent id="messageStart" > 
<messageEventDefinition messageRef="tns:newInvoice" /> 
</startEvent> 
</process> 


</definitions> 


Signal Start Event 


Description 描述 


signal 开始 事件 ， 可 以 用 来 通过 一 个 已 命名 的 信号 (signal) 来 启动 一 个 流程 实例 。 信号 可 以 在 流程 实例 内 部 使 用 “中 间 信 号 


抛 出 事务 "触发 ， 也 可 以 通过 API (runtimService.signalEventReceivedXXX 方法 ) 触发 。 两 种 情况 下 ， 
相同 名 称 的 signalStartEvent 都 会 启动 。 


注意 ， 在 两 种 情况 下 ， 都 可 以 选择 同步 或 异步 的 方式 启动 流程 实例 。 


所 有 流程 实例 中 拥有 


必须 向 API 传人 signalName， 这 是 signal 元 素 的 name 属性 值 ， 它 会 被 signalEventDefinition 的 signalRef 属性 引用 。 


Graphical notation 图 形 标记 
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信号 开始 事件 显示 为 一 个 中 间 包 含 信 号 事件 图 标的 圆圈 。 标 记 是 无 填充 的 ， 表 示 捕 获 (接收 ) 行为 


(人 ) 一 w 


XML representation 内 容 


signalStartEvent 的 XML 格式 是 标准 的 startEvent 声明 ， 其 中 包含 一 个 signalEventDefinition 子 元 素 : 


<process id="processwWithSignalStart1"> 
<startEvent id="thestart"> 


<signalEventDefinition id="theSignalEventDefinition" signalRef="thesignal" /> 
</startEvent> 


<sequenceFlow id="flowi" sourceRef="thesStart" targetRef="theTask" /> 
<userTask id="theTask" name="Task in process A" /> 


<sequenceFlow id="flow2" sourceRef="theTask" targetRef="theEnd" /> 
<endEvent id="theEnd" /> 
</process> 


Error Start Event 


Description 描述 

错误 开始 事件 可 以 用 来 触发 一 个 事件 子 流程 。 错误 开始 事件 不 能 用 来 启动 流程 实例 。 
错误 开始 事件 都 是 中 断 事件 。 

Graphical notation 图 形 标记 


错误 开始 事件 是 一 个 圆圈 ， 包 含 一 个 错误 事件 标记 。 标 记 是 白色 未 填充 的 ， 来 表示 捕获 (接收 ) 行为 。 


XML representation 内 容 


错误 开始 事件 的 XML 内 容 是 普通 开始 事件 定义 中 ， 包 含 一 个 errorEventDefinition 子 元 素 。 


<startEvent id="messageStart"”> 


<errorEventDefinition errorRef="someError" /> 
</startEvent> 


End Events 结束 事件 
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结束 事件 表示 〈 子 ) 流程 (分 支 ) 的 结束 。 结束 事件 都 是 触发 事件 。 这 是 说 当 流 程 达到 结束 事件 ， 会 触发 一 个 结果 。 结果 
的 类 型 是 通过 事件 的 内 部 黑色 图 标 表示 的 。 在 XML 内 容 中 ， 是 通过 包含 的 子 元 素 声明 的 。 


None End Event 空 结束 事件 


Description 描述 


结束 事件 意味 着 到 达 事件 时 不 会 指定 抛 出 的 结果 。 这 样 ， 引 擎 会 直接 结束 当前 执行 的 分 支 ， 不 会 做 其 他 事情 


Graphical notation 图 形 标记 


由 


空 结束 事件 是 一 个 粗 边 圆 圈 ， 内 部 没有 小 图 表 (无 结果 类 型 


XML representation 内 容 


空 结束 事件 的 XML 内 容 是 普通 结束 事件 定义 ， 不 包含 子 元 素 (其 他 结束 事件 类 型 都 会 包含 声明 类 型 的 子 元 素 ) 


<endEvent id="end" name="my end event" /> 


Error End Event 错误 结束 事件 


Description 描述 


当 流 程 执 行 到 错误 结束 事件 ， 流 程 的 当前 分 支 就 会 结束 ， 并 抛 出 一 个 错误 。 这 个 错误 可 以 被 对 应 的 中 间 边 界 错 误 事件 捕获 。 
如 果 找 不 到 匹配 的 边界 错误 事件 ， 就 会 抛 出 一 个 异常 。 


Graphical notation 图 形 标记 


错误 结束 事件 是 一 个 标准 的 结束 事件 〈 粗 边 圆圈 ) ， 内 部 有 错误 图 标 。 错误 图 表 是 全 黑 的 ， 表 示 触 发 语法 。 


XML representation 内 容 


错误 结束 事件 的 内 容 是 一 个 错误 事件 ， 子 元 素 为 errorEventDefinition。 


<endEvent id="myErrorEndEvent"> 
<errorEventDefinition errorRef="myError" /> 
</endEvent> 
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errorRef 属性 引用 定义 在 流程 外 部 的 error 元 素 : 


<error id="myError" errorCode="123" /> 


<process id="myProcess"> 


error 的 errorCode 用 来 查找 匹配 的 捕获 边界 错误 事件 。 如 果 errorRef 与 任何 error 都 不 匹配 ， 就 会 使 用 errorRef 来 作为 
errorCode 的 缩写 。 这 是 activiti 特定 的 缩写 。 更 具体 的 说 ， 见 如 下 代码 : 


<error id="myError” errorCode="error1i23" /> 
<process id="myProcess"> 


<endEvent id="myErrorEndEvent"> 
<errorEventDefinition errorRef="myError" /> 
</endEvent> 


等 价 于 


<endEvent id="myErrorEndEvent"> 
<errorEventDefinition errorRef="error123" /> 
</endEvent> 


注意 errorRef 必须 与 BPMN 2.0 格式 相符 ， 必须 是 一 个 合法 的 QName。 
Cancel End Event 取消 结束 事件 

[试验 ] 

Description 描述 


取消 结束 事件 只 能 与 BPMN 事 务 子 流 程 结合 使 用 。 当 到 达 取 消 结束 事件 时 ， 会 抛 出 取消 事件 ， 它 必须 被 取消 边界 事件 捕获 。 
取消 边界 事件 会 取消 事务 ， 并 触发 补偿 机 制 。 


Graphical notation 图 形 标记 


取消 结束 事件 显示 为 标准 的 结束 事件 ( 粗 边 圆圈 ) ， 包 含 一 个 取消 图 标 。 取消 图 标 是 全 黑 的 ， 表 示 触 发 语法 


3 


XML representation 内 容 


取消 结束 事件 内 容 是 一 个 结束 事件 ， 包含 cancelEventDefinition 子 元 素 。 


<endEvent id="myCancelEndEvent"> 
<cancelEventDefinition /> 
</endEvent> 


Boundary Events 边界 事件 


边界 事件 都 是 捕获 事件 ， 它 会 附 在 一 个 环节 上 。 (边界 事件 不 可 能 触发 事件 ) 。 这 意味 着 ， 当 节点 运行 时 ， 事件 会 监听 对 应 
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的 触发 类 型 。 当 事 件 被 捕获 ， 节 点 就 会 中 断 ， 同时 执行 事件 的 后 续 连 线 。 


所 以 边界 事件 的 定义 方式 都 一 样 : 


<boundaryEvent id="myBoundaryEvent" attachedToRef="theActivity"> 
<XxXXEventDefinition/> 
</boundaryEvent> 


边界 事件 使 用 如 下 方式 进行 定义 : 

e。 唯一 标识 (流程 范围 ) 

e。 使 用 caught 属性 引用 事件 衣服 的 节点 。 注意 边界 事件 和 它们 附加 的 节点 在 同一 级 别 上 。 (上 比如 ， 边 界 事件 不 是 包含 在 
节点 内 的 ) 。 

e。 格式 为 XXXEventDefinition 的 XML 子 元 素 (比如 ，TimerEventDefinition，ErrorEventDefinition， 等 等 ) 定义 了 边界 事 
件 的 类 型 。 参 考 对 应 的 边界 事件 类 型 ， 获得 更 多 细节 。 


Timer Boundary Event 定时 边界 事件 


Description 描述 


定时 边界 事件 就 是 一 个 暂停 等 待 警告 的 时 钟 。 当 流程 执行 到 绑 定 了 边界 事件 的 环节 ， 会 启动 一 个 定时 器 。 当 定 时 器 触发 时 
(比如 ， 一 定时 间 之 后 ) ， 环 节 就 会 中 断 ， 并 治 着 定时 边界 事件 的 外 出 连 线 继续 执行 。 


Graphical notation 图 形 标记 


定时 边界 事件 是 一 个 标准 的 边界 事件 (边界 上 的 一 个 圆圈 ) ， 内 部 是 一 个 定时 器 小 图 标 。 





各 





First line 
support 







Secondline 
support 






XML representation 内 容 


定时 器 边界 任务 定义 是 一 个 正规 的 边界 事件 。 指定 类 型 的 子 元 素 是 timerEventDefinition 元 素 。 


<boundaryEvent id="escalationTimer" cancelActivity="true" attachedToRef="firstLineSupport"> 
<timerEventDefinition> 
<timeDuration>PT4H</timeDuration> 
</timerEventDefinition> 
</boundaryEvent> 


请 参考 定时 事件 定义 获得 更 多 定时 其 配置 的 细节 。 


在 流程 图 中 ， 可 以 看 到 上 述 例子 中 的 圆圈 边线 是 虚线 : 
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各 


Main Task 







Escalation Task 


经 典 场景 是 发 送 一 个 升级 邮件 ， 但 是 不 打 断 正常 流程 的 执行 。 
因为 BPMN 2.0 中 ， 中 断 和 非 中 断 的 事件 还 是 有 区 别 的 。 默 认 是 中 断 事件 。 非 中 断 事件 的 情况 ， 不 会 中 断 原始 环节 ， 那 个 环 


节 还 停留 在 原 地 。 对 应 的 ， 会 创建 一 个 新 分 支 ， 并 治 着 事件 的 流向 继续 执行 。 在 XML 内 容 中 ， 要 把 cancelActivity 属性 设置 
为 false : 


<boundaryEvent id="escalationTimer" cancelActivity="false" attachedToRef='"firstLineSupport"/> 


注意 : 边界 定时 事件 只 能 在 job 执 行 器 启用 时 使 用 。 (上 比如， 把 activiti.cfg.xml 中 的 jobExecutorActivate 设置 为 ttue， 因 为 默 
认 job 执行 器 默认 是 禁用 的 ) 


Known issue with boundary events 边界 事件 的 已 知 问题 


使 用 边界 事件 有 一 个 已 知 的 同步 问题 。 目前 ， 不 能 边界 事件 后 面 不 能 有 多 条 外 出 连 线 (参考 ACT-47。 解决 这 个 问题 的 方法 
是 在 一 个 连 线 后 使 用 并 发 网 关 
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Error Boundary Event 错误 边界 事件 


Description 描述 
节点 边界 上 的 中 间 捕 获 错误 事件 ， 或 简写 成 边界 错误 事件 ， 它 会 捕获 节点 范围 内 抛 出 的 错误 。 


定义 一 个 边界 错误 事件 ， 大 多 用 于 内 该 子 流程 ， 或 调用 节点 ， 对 于 子 流 程 的 情况 ， 它 会 为 所 有 内 部 的 节点 创建 一 个 作用 范 
围 。 错误 是 由 错误 结束 事件 抛 出 的 。 这 个 错误 会 传递 给 上 层 作 用 域 ， 直 到 找到 一 个 错误 事件 定义 向 匹配 的 边界 错误 事件 。 


当 捕 获 了 错误 事件 时 ， 边 界 任务 绑 定 的 节点 就 会 销毁 ， 也 会 销毁 内 部 所 有 的 执行 分 支 (上 比如， 同步 节 点 ， 内 钳子 流程 ， 等 
等 ) 。 流程 执行 会 继续 治 着 边界 事件 的 外 出 连 线 继续 执行 。 


Graphical notation 图 形 标记 


边界 错误 事件 显示 成 一 个 普通 的 中 间 事 件 〈 圆 圈 内 部 有 一 个 小 圆圈 ) 放 在 节点 的 标记 上 ， 内 部 有 一 个 错误 小 图 标 。 错 误 小 图 
标 是 白色 的 ， 表 示 它 是 一 个 捕获 事件 。 
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mySubprocess 


XML representation 内 容 


边界 错误 事件 定义 为 普通 的 边界 事件 : 


<boundaryEvent id="catchError" attachedToRef="mySubProcess"> 
<errorEventDefinition errorRef="myError"/> 
</boundaryEvent> 


和 错误 结束 事件 一 样 ， errorRef 引用 了 process 元 素 外 部 的 一 个 错误 定义 : 


<error id="myError" errorCode="123" /> 


<process id="myProcess"> 


errorCode 用 来 匹配 捕获 的 错误 : 


e。 如 果 没 有 设置 errorRef， 边 界 错误 事件 会 捕获 所 有 错误 事件 ， 无 论 错误 的 errorCode 是 什么 。 

e@ 如 果 设 置 了 errorRef， 并 引用 了 一 个 已 存 的 错误 ， 边 界 事件 就 只 捕获 错误 代码 与 之 相同 的 错误 。 

e 如 果 设 置 了 errorRef， 但 是 BPMN 2.0 中 没有 定义 错误 ， errorRef 就 会 当做 errorCode 使 用 (和 错误 结束 事件 的 用 法 类 
似 ) 


Example 示例 
下 面 的 流程 实例 演示 了 如 何 使 用 错误 结束 事件 。 当 完 成 ' 审 核 僵 利 ' 这 个 用 户 任务 是 ， 如 果 没 有 提供 足够 的 信息 ， 就 会 抛 出 错 


误 ， 错 误会 被 子 流程 的 边界 任务 捕获 ， 所 有 ' 回 顾 销售 ' 子 流程 中 的 所 有 节点 都 会 销毁 。 〈 即 使 ' 审 核 客 户 比率 ' 还 没有 完成 ) ， 
并 创建 一 个 ' 提 供 更 多 信息 ' 的 用 户 任务 。 
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Review sales lead 


Review 
customer rating 
Review 
profitability 


[之 


Provide new 
sales lead 






Store lead in 
CRM system (ee 





Enough 
information? 














Provide 
additional 
details 


这 个 流程 也 放 在 demo 中 了 。 流 程 XML 和 单元 测试 可 以 在 org.activiti.examples.bpmn.event.error 包 下 找到 


Signal Boundary Event 信号 边界 事件 


Description 描述 

节点 边界 的 中 间 捕 获 信号 ， 或 简称 为 边界 信号 事件 ， 它 会 捕获 信和 号 定义 引用 的 相同 信号 名 的 信号 。 
注意 : 与 其 他 事件 (比如 边界 错误 事件 ) 不 同 ， 边 界 信号 事件 不 只 捕获 它 绑 定 方位 的 信号 。 

信号 事件 是 一 个 全 局 的 范围 (广播 语义 ) ， 就 是 说 信号 可 以 在 任何 地 方 触 发 ， 即便 是 不 同 的 流程 实例 。 


注意 : 和 其 他 事件 (上 比如 边界 错误 事件 ) 不 同 ， 捕 获 信号 后 ， 不 会 停止 信号 的 传播 。 如 果 你 有 两 个 信号 边界 事件 ， 它 们 捕获 
相同 的 信号 事件 ， 两 个 边界 事件 都 会 被 触发 ， 即使 它们 在 不 同 的 流程 实例 中 。 


Graphical notation 图 形 标记 


边界 信号 事件 显示 为 普通 的 中 间 事 件 〈 圆 圈 里 有 个 小 圆圈 ) ， 位 置 在 节点 的 边缘 ， 内 部 有 一 个 信号 小 图 标 。 信 号 图 标 是 白色 
的 (未 填充 ) ， 来 表示 捕获 的 意思 。 


名 


do something 






XML representation 内 容 


边界 信号 事件 定义 为 普通 的 边界 事件 : 


<boundaryEvent id="boundary" attachedToRef="task" cancelActivity="true"> 
<signalEventDefinition signalRef="alertSignal"/> 
</boundaryEvent> 
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Example 实例 
参考 信号 事件 定义 ) 章 节 
Message Boundary Event 消息 边界 事件 


Description 描述 





节点 边界 上 的 中 间 捕 获 消息 ， 或 简称 边界 消息 事件 ， 根 据 引用 的 消息 定义 捕获 相同 消息 名 称 的 消息 。 
Graphical notation 图 形 标记 


边界 消息 事件 显示 成 一 个 普通 的 中 间 事 件 (圆圈 里 有 个 小 圆圈 ) ， 位 于 节点 边缘 ， 内 部 是 一 个 消息 小 图 标 。 消 息 图 标 是 白色 
(无 填充 ) ， 表 示 捕 获 语义 







UserTask 


注意 ， 边 界 消息 事件 可 能 是 中 断 ( 右 侧 ) 或 非 中 断 ( 左 侧 ) 的 。 
XML representation 内 容 


边界 消息 事件 定义 为 标准 的 边界 事件 : 


<boundaryEvent id="boundary" attachedToRef="task" cancelActivity="true"> 
<messageEventDefinition messageRef="newCustomerMessage"/> 
</boundaryEvent> 


Example 实例 

参考 消息 事件 定义 章节 

Cancel Boundary Event 取消 边界 事件 

[试验 ] 

Description 描述 

在 事务 性 子 流程 的 边界 上 的 中 间 捕获 取消 ， 或 简称 为 边界 取消 事件 cancel event， 当 事 务 取消 时 触发 。 当 取消 边界 事件 触发 
时 ， 首 先 中 断 当 前 作用 域 的 所 有 执行 。 然后 开始 补偿 事务 内 的 所 有 激活 的 补偿 边界 事件 。 补偿 是 同步 执行 的 。 例 如 ， 离 开 事 
务 钱 ， 边 界 事务 会 等 待 补偿 执行 完毕 。 当 补 偿 完 成 后 ， 事 务 子 流程 会 治 着 取消 边界 事务 的 外 出 连 线 继续 执行 。 

注意 : 每 个 事务 子 流 程 只 能 有 一 个 取消 边界 事件 。 

注意 : 如 果 事务 子 流 程 包含 内 褒 子 流程 ， 补 偿 只 会 触发 已 经 成 功 完 成 的 子 流程 。 

注意 : 如 果 取消 边界 子 流程 对 应 的 事务 子 流程 配置 为 多 实例 ， 如 果 一 个 实例 触发 了 取消 ， 就 会 取消 所 有 实例 。 
Graphical notation 图 形 标记 
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取消 边界 事件 显示 为 了 一 个 普通 的 中 间 事 件 (圆圈 里 套 小 圆圈 ) ， 在 节点 的 边缘 ， 内 部 是 一 个 取消 小 图 标 。 取 消 图 标 是 白色 
(无 填充 ) ， 表 明 是 捕获 语义 。 


transaction subprocess 





XML representation 内 容 


取消 边界 事件 定义 为 普通 边界 事件 : 


<boundaryEvent id="boundary" attachedToRef="transaction" > 
<cancelEventDefinition /> 
</boundaryEvent> 


因为 取消 边界 事件 都 是 中 断 的 ， 所 以 不 需要 使 用 cancelActivity 属性 。 


Compensation Boundary Event 补偿 边界 事件 

[试验 ] 

Description 描述 

节点 边界 的 中 间 捕 获 补偿 ， 或 简称 为 补偿 边界 事件 ， 可 以 用 来 设置 一 个 节点 的 补偿 处 理 器 。 

补偿 边界 事件 必须 使 用 直接 引用 设置 唯一 的 补偿 处 理 器 。 

补偿 边界 事件 与 其 他 边界 事件 的 策略 不 同 。 其 他 边界 事件 (比如 信号 边界 事件 ) 当 到 达 关 联 的 节点 就 会 被 激活 。 离开 节点 
时 ， 就 会 挂 起 ， 对 应 的 事件 订阅 也 会 取消 。 补偿 边界 事件 则 不 同 。 补 偿 边 界 事件 在 关联 的 节点 成 功 完成 时 激活 。 当 补 偿 事 件 
触发 或 对 应 流程 实例 结束 时 ， 事 件 订阅 才 会 删除 。 它 遵 循 如 下 规则 : 

。 补偿 触发 时 ， 补 偿 边 界 事件 对 应 的 补偿 处 理 器 会 调用 相同 次 数 ， 根 据 它 对 应 的 节点 的 成 功 次 数 。 

e 如 果 补 偿 边 界 事件 关联 到 多 实例 节点 ， 补偿 事件 会 订阅 每 个 实例 。 

。 如 果 补 偿 边界 事件 关联 的 节点 中 包含 循环 ， 补偿 事件 会 在 每 次 节点 执行 时 进行 订阅 。 

e 如 果 流 程 实例 结束 ， 订 阅 的 补偿 事件 都 会 结束 。 

注意 : 补偿 边界 事件 不 支持 内 馈 子 流程 。 

Graphical notation 图 形 标记 


补偿 边界 事件 显示 为 标准 中 间 事 件 (圆圈 里 套 圆圈 ) ， 位 于 节点 边缘 ， 内 部 有 一 个 补偿 小 图 标 。 补 偿 图 标 是 白色 的 (无 填 
充 ) ， 表 示 捕 获 语义 。 另 外 ， 下 面 的 图 形 演示 了 使 用 无 方向 的 关联 ， 为 边界 事件 设置 补偿 处 理 器 。 
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book hotel 





cancel hotel 
reservation 


« 










XML representation 内 容 


补偿 边界 事件 定义 为 标准 边界 事件 : 


<boundaryEvent id="compensateBookHotelEvt" attachedToRef="bookHotel" > 
<compensateEventDefinition /> 
</boundaryEvent> 


<association associationDirection="One" id="al" sourceRef="compensateBookHotelEvt" targetRef="undoBookHotel" /> 


<serviceTask id="undoBookHotel" isForCompensation="true" activiti:class="..." /> 


因为 补偿 边界 事件 在 节点 成 功 完 成 后 激活 ， 所 以 不 支持 cancelActivity 属 性 。 


Intermediate Catching Events 中 间 捕 获 事件 


所 有 中 间 捕 获 事 件 都 使 用 同样 的 方式 定义 : 


<intermediateCatchEvent id="myIntermediateCatchEvent" > 
<XXXEventDefinition/> 
</intermediateCcatchEvent> 


中 间 捕 获 事件 的 定义 包括 
e 唯一 标识 流程 范围 内 ) 
e@ 一 个 结构 为 XXXEventDefinition 的 XML 子 元 素 (比如 TimerEventDefinition 等 ) 定义 了 中 间 捕 获 事件 的 类 型 。 参 考 特定 
的 捕获 事件 类 型 ， 获得 更 多 详情 。 
Timer Intermediate Catching Event 定时 中 间 捕 获 事 件 


Description 描述 


定时 中 间 事 件 作为 一 个 监听 器 。 当 执行 到 达 捕 获 事件 节点 ， 就 会 启动 一 个 定时 器 。 当 定 时 器 触发 上 比如， 一 段 时 间 之 后 ) ， 
流程 就 会 治 着 定时 中 间 事 件 的 外 出 节点 继续 执行 。 


Graphical notation 图 形 标记 


定时 器 中 间 事 件 显示 成 标准 中 间 捕获 事件 ， 内 部 是 一 个 定时 器 小 图 标 
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XML representation 内 容 


定时 器 中 间 事 件 定义 为 标准 中 间 捕 获 事 件 。 指定 类 型 的 子 元 素 为 timerEventDefinition 元 素 


<intermediateCatchEvent id="timer"> 
<timerEventDefinition> 
<timeDuration>PT5M</timeDuration> 
</timerEventDefinition> 
</intermediateCcatchEvent> 


参考 定时 器 事件 定义 了 解 配置 信息 。 

Signal Intermediate Catching Event 
Description 描述 

中 间 捕获 信号 事件 通过 引用 信号 定义 来 捕获 相同 信号 名 称 的 信号 。 


注意 : 与 其 他 事件 (比如 错误 事件 ) 不 同 ， 信 号 不 会 在 捕获 之 后 被 消费 。 如 果 你 有 两 个 激活 的 信号 边界 事件 捕获 相同 的 信号 
事件 ， 两 个 边界 事件 都 会 被 触发 ， 即便 它们 在 不 同 的 流程 实例 中 。 


Graphical notation 图 形 标记 


中 间 信 号 捕获 事件 显示 为 一 个 普通 的 中 间 事 件 (圆圈 套 圆圈 ) ， 内 部 有 一 个 信号 小 图 标 。 信 号 小 图 标 是 白色 的 (无 填充 ) 
表示 捕获 语义 。 


new customer 


XML representation 内 容 


信号 中 间 事 件 定 义 为 普通 的 中 间 捕 获 事 件 。 对 应 类 型 的 子 元 素 是 signalEventDefinition 元 素 。 


<intermediateCatchEvent id="signal"> 
<signalEventDefinition signalRef="newCustomerSignal" /> 
</intermediateCatchEvent> 


Example 实例 


溃 
By 
a 
dl 
灿 
赴 
闭 
ba 
贡 


Message Intermediate Catching Event 消息 中 间 捕 获 事 件 
Description 描述 
一 个 中 间 捕 获 消息 事件 ， 捕 获 特定 名 称 的 消息 


Graphical notation 图 形 标记 





中 间 捕 获 消息 事件 显示 为 普通 中 间 事 件 〈 圆 圈套 圆圈 ) ， 内 部 是 一 个 消息 小 图 标 。 消 息 图 标 是 白色 的 无 填充 ) ， 表示 捕获 


语义 。 
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cancel order 


XML representation 内 容 


消息 中 间 事 件 定义 为 标准 中 间 捕 获 事 件 。 指定 类 型 的 子 元 素 是 messageEventDefinition 元 素 。 


<intermediateCatchEvent id="message"> 
<messageEventDefinition signalRef="newCustomerMessage" /> 
</intermediateCatchEvent> 


Example 实例 
参考 消息 事件 定义 章节 。 
Intermediate Throwing Event 内 部 触发 事件 


所 有 内 部 触发 事件 的 定义 都 是 同样 


<intermediateThrowEvent id="myIntermediateThrowEvent" > 
<XXXEventDefinition/> 
</intermediateThrowEvent> 


内 部 触发 事件 定义 包含 
e@ 唯一 标识 (流程 范围 ) 
e 使 用 格式 为 XXXEventDefinition 的 XML 子 元 素 (比如 signalEventDefinition 等 ) 定义 中 间 触 发 事件 的 类 型 。 参考 对 应 触 
发 事件 的 类 型 ， 了 解 更 多 信息 
Intermediate Throwing None Event 


下 面 的 流程 图 演示 了 一 个 空中 间 触 发 事件 的 例子 ， 它 通常 用 于 表示 流程 中 的 某 个 状态 。 






do another 
thing 








do something 









result achieved 
通过 添加 执行 监听 器 ， 就 可 以 很 好 地 监控 一 些 KPl。 


<intermediateThrowEvent id="noneEvent"> 
<extensionElements> 
<activiti:executionListener class="org.activiti.engine.test.bpmn.event.IntermediateNoneEventTest$MyExecutionListene 
</extensionElements> 
</intermediateThrowEvent> 


国 这 


这 里 你 可 以 添加 自己 的 代码 ， 把 事件 发 送 给 BAM 工 具 或 DWH。 引 擎 不 会 为 这 个 事件 做 任何 事情 ， 它 直接 径直 通过 








Signal Intermediate Throwing Event 信号 中 间 触 发 事件 
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Description 描述 

中 间 触 发 信号 事件 为 定义 的 信号 抛 出 一 个 信号 事件 。 

在 activiti 中 ， 信 号 会 广播 到 所 有 激活 的 处 理 器 中 〈 比 如 ， 所 以 捕获 信号 事件 ) 。 信号 可 以 通过 同步 和 异步 方式 发 布 。 

。 默认 配置 下 ， 信 号 是 同步 发 送 的 。 就 是 说 ， 抛 出 事件 的 流程 实例 会 等 到 信号 发 送 给 所 有 捕获 流程 实例 才 继 续 执行 。 捕获 
流程 实例 也 会 在 触发 流程 实例 的 同一 个 事务 中 执行 ， 意 味 着 如 果 某 个 监听 流程 出 现 了 技术 问题 ( 抛 出 异常 ) ， 所 有 相关 
的 实例 都 会 失 改 。 


e。 信号 也 可 以 异步 发 送 。 这 时 它 会 在 到 达 抛 出 信号 事件 后 决定 哪些 处 理 器 是 激活 的 。 对 这 些 激活 的 处 理 器 ， 会 保存 一 个 异 
步 提 醒 消 息 (任务 ) ， 并 发 送 给 jobExecutor。 


Graphical notation 图 形 标记 


中 间 信 号 触发 事件 显示 为 普通 中 间 事 件 (圆圈 套 圆圈 ) ， 内 部 又 一 个 信号 小 图 标 。 信 号 图 标 是 黑色 的 (有 填充 ) ， 表 示 触 发 


语义 。 


new customer 


XML representation 内 容 


消息 中 间 事 件 定义 为 标准 中 间 触 发 事件 。 指定 类 型 的 子 元 素 是 signalEventDefinition 元 素 。 


<intermediateThrowEvent id="signal"> 
<signalEventDefinition signalRef="newCustomerSignal" /> 
</intermediateThrowEvent> 


异步 信号 事件 如 下 所 示 : 


<intermediateThrowEvent id="signal"> 
<signalEventDefinition signalRef="newCustomerSignal" activiti:async="true" /> 
</intermediateThrowEvent> 


Example 实例 

参考 信号 事件 定义 章节 。 

Compensation Intermediate Throwing Event 

[试验 ] 

Description 描述 

中 间 触 发 补偿 事件 可 以 用 来 触发 补偿 。 

触发 补偿 : 补偿 可 以 由 特定 节点 或 包含 补偿 事件 的 作用 域 触发 。 补偿 是 通过 分 配给 节点 的 补偿 处 理 器 来 完成 的 。 
。 当 补 偿 由 节点 触发 ， 对 应 的 补偿 处 理 器 会 根据 节点 成 功 完成 的 次 数 执行 相同 次 数 。 

e 如 果 补 偿 由 当前 作用 域 触发 ， 当 前 作用 域 的 所 有 节点 都 会 执行 补偿 ， 也 包含 并 发 分 支 。 


e 补偿 的 触发 是 继承 式 的 : 如 果 执 行 补偿 的 节点 是 子 流程 ， 补 偿 会 作用 到 子 流程 中 包含 的 所 有 节点 。 如 果子 流程 是 内 蔡 节 
点 ， 补 偿 会 递 为 触发 。 然而 ， 补 偿 不 会 传播 到 流程 的 上 层 : 如 果 补 偿 在 子 流程 中 触发 ， 不 会 传播 到 子 流程 范围 外 。 
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bpmn 规 范 定义 ， 由 节点 触发 的 流程 只 会 作用 到 “ 子 流程 同一 级 别 ”。 
e activiti 的 补偿 执行 次 序 与 流程 执行 顺序 相反 。 以 为 着 最 后 完成 的 节点 会 最 先 执行 补偿 ， 诸 如 此 类 。 
e@ 中 间 触 发 补偿 事件 可 以 用 来 补偿 成 功 完 成 的 事务 性 子 流程 。 


注意 : 如 果 补 偿 被 一 个 包含 子 流程 的 作用 域 触发 ， 子 流程 还 包含 了 关联 补偿 处 理 器 的 节点 ， 补 偿 只 会 传播 到 子 流程 ， 如 果 它 
已 经 成 功 完 成 了 。 如 果子 流程 中 的 节点 也 完成 了 ， 并 关联 了 补偿 处 理 器 ， 如 果子 流程 包含 的 这 些 节点 还 没有 完成 ， 就 不 会 执 
行 补偿 处 理 器 。 参考 下 面 实例 : 


入 


review 
book hotel bookings 


cancel hotel 
reservation 


« 









charge credit 
card 





cancel reservations 


这 个 流程 中 ， 我 们 有 两 个 并 发 分 支 ， 一 些 分 支 时 内 旗子 流程 ， 一 个 是 “使 用 信用 卡 " 节 点 。 假 设 两 个 分 支 都 启动 了 ， 第 一 个 分 
支 等 待 用 户 完成 “审核 预定 ”任务 。 第 二 个 分 支 执行 “使 用 信用 卡 "节点 ， 并 发 生 了 一 个 错误 ， 这 导致 “取消 预定 "事件 ， 并 触发 补 
偿 。 这 时 ， 并 发 子 流程 还 没有 结束 ， 意 味 着 补偿 事件 不 会 传播 给 子 流程 ， 所 以 “取消 旅店 预定 "这 个 补偿 处 理 器 不 会 执行 。 如 
果 用 户 任务 (就 是 内 谋 子 流程 ) 在 “取消 预定 "之 前 完成 了 ， 补偿 就 会 传播 给 内 嵌 子 流程 。 


流程 变量 : 当 补 偿 内 帜 子 流程 时 ， 用 来 执行 补偿 处 理 器 的 分 支 可 以 访问 子 流程 的 本 地 流程 实例 ， 因为 这 时 它 是 子 流程 完成 的 
分 支 。 为 了 实现 这 个 功能 ， 流 程 变量 的 快照 会 分 配给 分 支 (为 执行 子 流程 而 创建 的 分 支 ) 。 为 此 ， 有 以 下 限制 条 件 : 


e 补偿 处 理 器 无 法 访问 子 流程 内 部 创建 的 ， 添 加 到 同步 分 支 的 变量 。 

e 分 配给 分 支 的 流程 变量 在 继承 关系 上 层 的 (分 配给 流程 实例 的 流程 变量 没有 包含 在 快照 中 ) : 补偿 触发 时 ， 补 偿 处 理 器 
通过 它们 所 在 的 地 方 访 问 这 些 流程 变量 。 

e 变量 快照 只 用 于 内 嵌 子 流程 ， 不 适用 其 他 节点 。 


已 知 限制 : 
e WaitForCompletion="false" 还 不 支持 。 当 补偿 使 用 中 间 触 发 补偿 事件 触发 时 ， 事件 没有 等 待 ， 在 补偿 成 功 结束 后 。 
e 补偿 自己 由 并 发 分 支 执行 。 并 发 分 支 的 执行 顺序 与 被 补偿 的 节点 完成 次 序 相 反 。 未 来 activiti 可 能 支持 选项 来 顺序 执行 


补偿 。 
e@ 补偿 不 会 传播 给 callActivity 调 用 的 子 流程 实例 。 
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Graphical notation 图 形 标记 


中 间 补 偿 触 发 事件 显示 为 标准 中 间 事 件 〈 圆 圈套 圆圈 ) ， 内 部 是 一 个 补偿 小 图 标 。 补 偿 图 标 是 黑色 的 〈 有 填充 ) ， 表 示 触 发 


语义 。 


cancel reservations 
XML representation 内 容 
补偿 中 间 事 件 定义 为 普通 的 中 间 触 发 事件 。 对 应 类 型 的 子 元 素 是 compensateEventDefinition 元 素 。 


<intermediateThrowEvent id="throwCompensation"> 
<compensateEventDefinition /> 
</intermediateThrowEvent> 


另外 ， 可 选 参数 activityRef 可 以 用 来 触发 特定 作用 域 /节点 的 补偿 : 


<intermediateThrowEvent id="throwCompensation"> 
<compensateEventDefinition activityRef="bookHotel" /> 
</intermediateThrowEvent> 
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Sequence Flow 顺序 流 


Description 描述 


顺序 流 是 连接 两 个 流程 节点 的 连 线 。 流程 执行 完 一 个 节点 后 ， 会 治 着 节点 的 所 有 外 出 顺序 流 继 续 执行 。 就 是 说 ，BPMN 2.0 
默认 的 行为 就 是 并 发 的 : 两 个 外 出 顺序 流 会 创造 两 个 单独 的 ， 并 发 流程 分 支 。 


Graphical notation 图 形 标记 


顺序 流星 示 为 从 起 点 到 终点 的 箭头 。 箭头 总 是 指向 终点 


六 


XML representation 内 容 


顺序 流 需要 流程 范围 内 唯一 的 id， 以 及 对 起 点 与 终点 元 素 的 引用 。 


<sequenceFlow id="flowi1" sourceRef="thestart" targetRef="theTask" /> 


Conditional sequence flow 条 件 顺 序 流 


Description 描述 


可 以 为 顺序 流 定 义 一 个 条 件 。 离 开 一 个 BPMN 2.0 节 点 时 ， 默认 会 计算 外 出 顺序 流 的 条 件 。 如 果 条 件 结果 为 true, 就 会 选择 外 
出 顺序 流 继续 执行 。 当 多 条 顺序 流 被 选中 时 ， 就 会 创建 多 条 分 支 ， 流程 会 继续 以 并 行 方式 继续 执行 。 


注意 : 上 面 的 讨论 仅 涉及 BPMN 2.0 节点 (和 事件 ) ， 不 包括 网 关 。 网 关 会 用 特定 的 方式 处 理 顺 序 流 中 的 条 件 ， 这 和 与 网 关 
类 型 相关 。 


Graphical notation 图 形 标记 


条 件 顺 序 流 显示 为 一 个 正常 的 顺序 流 ， 不 过 在 起 点 有 一 个 蓉 形 。 条 件 表达 式 也 会 星 示 在 顺序 流 上 。 






conditionExpression 


XML representation 内 容 





条 件 顺 序 流 定义 为 一 个 正常 的 顺序 流 ， 包含 conditionExpression 子 元 素 。 注意 目前 只 支持 tFormalExpressions， 如 果 没有 
设置 xsi:type=”"，, 就 会 默认 值 支持 目前 支持 的 表达 式 类 型 


<sequenceFlow id="flow" sourceRef="theStart" targetRef="theTask"> 
<conditionExpression xsi:type="tFormalExpression"> 
<![CDATA[${order .price > 100 && order.price < 250}]]> 
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</conditionExpression> 
</sequenceFlow> 


当前 条 件 表达 式 只 能 使 用 UEL， 可 以 参考 表达 式 章节 获取 更 多 信息 。 使 用 的 表达 式 需 要 返回 boolean 值 ， 否 则 会 在 解析 表 
达 式 时 抛 出 异常 。 


e 下 面 的 例子 引用 了 流程 变量 的 数据 ， 通过 getter 调用 JavaBean。 
e@ 这 个 例子 通过 调用 方法 返回 一 个 boolean 值 。 


在 activiti 发 布 包 中 ， 包 含 以 下 流程 实例 ， 使 用 了 值 和 方法 表达 式 (参考 org.activiti.examples.bpmn.expression ) 包 ) 






各 





2501} 


Standard 
service 






Ss{order.price < 










各 


Premium 
Service 


S{order.isPremiurm Order} 


Default sequence flow 默认 顺序 流 


Description 描述 


所 有 的 BPMN 2.0 任务 和 网 关 都 可 以 设置 一 个 默认 顺序 流 。 只 有 在 节点 的 其 他 外 出 顺序 流 不 能 被 选中 是 ， 才 会 使 用 它 作 为 外 
出 顺序 流 继续 执行 。 默认 顺序 流 的 条 件 设置 不 会 生效 。 


Graphical notation 图 形 标记 
默认 顺序 流 显示 为 了 普通 顺序 流 ， 起 点 有 一 个 “ 斜 线 "标记 。 


一 全 


XML representation 内 容 


默认 顺序 流通 过 对 应 节点 的 default 属性 定义 。 下 面 的 XML 代码 演示 了 排他 网 关 设 置 了 默认 顺序 流 flow 2 。 只 有 当 
conditionA 和 conditionB 都 返回 false 时 ， 才 会 选择 它 作为 外 出 连 线 继续 执行 。 
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<exclusiveGateway id="exclusiveGw" name="Exclusive Gateway" default="flow2" /> 
<sequenceFlow id="flow1"” sourceRef="exclusiveGw" targetRef="task1"> 


<conditionExpression xsi:type="tFormalExpression">${conditionA}</conditionExpression> 
</sequenceFlow> 


<sequenceFlow id="flow2" sourceRef="exclusiveGw" targetRef="task2"/> 
<sequenceFlow id="flow3" sourceRef="exclusiveGw" targetRef="task3"> 


<conditionExpression xsi:type="tFormalExpression">${conditionB}</conditionExpression> 
</sequenceFlow> 


对 应 下 面 的 图 形 显示 : 






condition A 入 


condition B 
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Gateways 网 关 


网 关 用 来 控制 流程 的 流向 (或 像 BPMN 2.0 里 描述 的 那样 ， 流 程 的 tokens。) 网 关 可 以 消费 也 可 以 生成 token。 


网 关 显示 成 萎 形 图 形 ， 内 部 有 有 一 个 小 图 标 。 图 标 表 示 网 关 的 类 型 


Exclusive Gateway 排他 网 关 


Description 描述 

排他 网 关 (也 叫 异 或 (XOR) 网 关 ， 或 更 技术 性 的 叫 法 基于 数据 的 排他 网 关 ) ， 用 来 在 流程 中 实现 决策 。 当 流程 执行 到 这 
个 网 关 ， 所 有 外 出 顺序 流 都 会 被 处 理 一 通 。 其 中 条 件 解析 为 true 的 顺序 流 (或 者 没有 设置 条 件 ， 概 念 上 在 顺序 流 上 定义 了 一 
个 'true') 会 被 选中 ， 让 流程 继续 运行 。 

注意 这 里 的 外 出 顺序 流 与 BPMN 2.0 通常 的 概念 是 不 同 的 。 通 常情 况 下 ， 所 有 条 件 结果 为 true 的 顺序 流 都 会 被 选中 ， 以 并 


行 方式 执行 ， 但 排他 网 关 只 会 选择 一 条 顺序 流 执行 。 就 是 说 ， 虽 然 多 个 顺序 流 的 条 件 结果 为 true， 那么 XML 中 的 第 一 个 顺序 
流 (也 只 有 这 一 条 ) 会 被 选中 ， 并 用 来 继续 运行 流程 。 如 果 没 有 选中 任何 顺序 流 ， 会 抛 出 一 个 异常 


Graphical notation 图 形 标记 


排他 网 关 显 示 成 一 个 普通 网 关 (比如 ， 蓉 形 图 形 ) ， 内 部 是 一 个 “X" 图 标 ， 表 示 异 或 (XOR) 语义 。 注意 ， 没 有 内 部 图 标的 
网 关 ， 默 认为 排他 网 关 。 BPMN 2.0 规范 不 允许 在 同一 个 流程 定义 中 同时 使 用 没有 X 和 有 X 的 萎 形 图 形 。 


OO 


XML representation 内 容 


排他 网 关 的 XML 内 容 是 很 直接 的 : 用 一 行 定 义 了 网 关 ， 条 件 表达 式 定义 在 外 出 顺序 流 中 。 参考 条 件 顺序 流 获得 这 些 表 达 式 
的 可 用 配置 。 


参考 下 面 模型 实例 : 
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$finput == 1} 





${input == 2} 


它 对 应 的 XML 内 容 如 下 : 


<exclusiveGateway id="exclusiveGw" name="Exclusive Gateway" /> 


<sequenceFlow id="flow2" sourceRef="exclusiveGw" targetRef="theTask1"> 
<conditionExpression xsi:type="tFormalExpression">${input == 1}</conditionExpression> 
</sequenceFlow> 


<sequenceFlow id="flow3" sourceRef="exclusiveGw" targetRef="theTask2"> 
<conditionExpression xsi:type="tFormalExpression">${input == 2}</conditionExpression> 
</sequenceFlow> 





<sequenceFlow id="flow4" sourceRef="exclusiveGw" targetRef="theTask3"> 
<conditionExpression xsi:type="tFormalExpression">${input == 3}</conditionExpression> 
</sequenceFlow> 





Parallel Gateway 并 行 网 关 


Description 描述 


网 关 也 可 以 表示 流程 中 的 并 发 情况 。 最 简单 的 并 发 网 关 是 并 行 网 关 ， 它 允许 将 流程 分 成 多 条 分 支 ， 也 可 以 把 多 条 分 支 汇聚 到 
一 起 。 


并 行 网 关 的 功能 是 基于 进入 和 外 出 的 顺序 流 的 : 


e 分 支 : 并 行 后 的 所 有 外 出 顺序 流 ， 为 每 个 顺序 流 都 创建 一 个 并 发 分 支 。 
e 汇聚 : 所 有 到 达 并 行 网 关 ， 在 此 等 待 的 进入 分 支 ， 直到 所 有 进入 顺序 流 的 分 支 都 到 达 以 后 ， 流程 就 会 通过 汇聚 网 关 。 


注意 ， 如 果 同 一 个 并 行 网 关 有 多 个 进入 和 多 个 外 出 顺序 流 ， 它 就 同时 具有 分 支 和 汇聚 功能 。 这 时 ， 网 关 会 先 汇聚 所 有 进入 的 
顺序 流 ， 然 后 再 切 分 成 多 个 并 行 分 支 。 


与 其 他 网 关 的 主要 区 别 是 ， 并 行 网 关 不 会 解析 条 件 。 即使 顺序 流 中 定义 了 条 件 ， 也 会 被 忽略 。 
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Graphical notation 图 形 标记 


并 行 网 关 显 示 成 一 个 普通 网 关 〈 蓉 形 ) 内 部 是 一 个 “加 号 "图 标 ， 表示 “与 (AND) "语义 。 


心 


Receive 


payment 







心 


Archive order 





各 


Ship order 





XML representation 内 容 


定义 并 行 网 关 只 需要 一 行 XML : 
<parallelGateway id="myParallelGateway" /> 


实际 发 生 的 行为 分支， 聚合 ， 同 时 分 支 聚 合 ) ， 要 根据 并 行 网 关 的 顺序 流 来 决定 。 


参考 如 下 代码 : 


<startEvent id="thestart" /> 
<sequenceFlow id="flowi1" sourceRef="thestart" targetRef="fork" /> 


<parallelGateway id="fork" /> 
<sequenceFlow sourceRef="fork" targetRef="receivePayment" /> 


<sequenceFlow sourceRef="fork" targetRef="shipOrder" /> 


<userTask id="receivePayment" name="Receive Payment" /> 
<sequenceFlow sourceRef="receivepayment" targetRef="join" /> 


<userTask id="shipOrder" name="Ship Order" /> 
<sequenceFlow sourceRef="shipOrder" targetRef="join" /> 


<parallelGateway id="join" /> 
<sequenceFlow sourceRef="join" targetRef="archiveOrder" /> 


<userTask id="archiveOrder" name="Archive Order" /> 
<sequenceFlow sourceRef="archiveOrder" targetRef="theEnd" /> 


<endEvent id="theEnd" /> 


上 面 例子 中 ， 流 程 启动 之 后 ， 会 创建 两 个 任务 : 


ProcessInstance pi = runtimeService.startProcessInstanceByKey("forkJoin"); 
TaskQuery query = taskService.createTaskQuery() 
.processInstanceId(pi.getId()) 
.orderByTaskName() 
SCOi 


List<Task> tasks = query.1ist(); 
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assertEquals(2, tasks.size()); 


Task task1 = tasks.get(0); 

assertEquals("Receive Payment", taski1.getName()); 
Task task2 = tasks.get(1); 

assertEquals("Ship Order", task2.getName()); 


当 两 个 任务 都 完成 时 ， 第 二 个 并 行 网 关 会 汇聚 两 个 分 支 ， 因 为 它 只 有 一 条 外 出 连 线 ， 不 会 创建 并 行 分 支 ， 只 会 创建 轨 档 订单 
任务 。 


注意 并 行 网 关 不 需要 是 “平衡 的 ”( 比 如 ， 对 应 并 行 网 关 的 进入 和 外 出 节点 数目 相等 ) 。 并 行 网 关 只 是 等 待 所 有 进入 顺序 流 ， 
并 为 每 个 外 出 顺序 流 创 建 并 发 分 支 ， 不 会 受到 其 他 流程 节点 的 影响 。 所 以 下 面 的 流程 在 BPMN 2.0 中 是 合法 的 : 






中 






中 3 
| 


Inclusive Gateway 包含 网 关 






Description 描述 


包含 网 关 可 以 看 做 是 排他 网 关 和 并 行 网 关 的 结合 体 。 和 排他 网 关 一 样 ， 你 可 以 在 外 出 顺序 流 上 定义 条 件 ， 包 含 网 关 会 解析 它 
们 。 但 是 主要 的 区 别 是 包含 网 关 可 以 选择 多 于 一 条 顺序 流 ， 这 和 并 行 网 关 一 样 。 


包含 网 关 的 功能 是 基于 进入 和 外 出 顺序 流 的 : 

e 分 支 : 所 有 外 出 顺序 流 的 条 件 都 会 被 解析 ， 结 果 为 true 的 顺序 流 会 以 并 行 方式 继续 执行 ， 会 为 每 个 顺序 流 创建 一 个 分 
支 。 

e。 汇聚 : 所 有 并 行 分 支 到 达 包 含 网 关 ， 会 进入 等 待 章 台 ， 直到 每 个 包含 流程 token 的 进入 顺序 流 的 分 支 都 到 达 。 这 是 与 并 
行 网 关 的 最 大 不 同 。 换 句 话说， 包含 网 关 只 会 等 待 被 选中 执行 了 的 进入 顺序 流 。 在 汇聚 之 后 ， 流 程 会 穿 过 包含 网 关 继 续 
执行 。 


注意 ， 如 果 同 一 个 包含 节点 拥有 多 个 进入 和 外 出 顺序 流 ， 它 就 会 同时 含有 分 支 和 汇聚 功能 。 这 时 ， 网 关 会 先 汇聚 所 有 拥有 流 
程 token 的 进入 顺序 流 ， 再 根据 条 件 判 断 结 果 为 true 的 外 出 顺序 流 ， 为 它们 生成 多 条 并 行 分 支 。 


Graphical notation 图 形 标记 


并 行 网 关 显 示 为 一 个 普通 网 关 (菱形 ) ， 内 部 包含 一 个 圆圈 图 标 。 
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A 


Receive 
payment 


paymentReceived == false 






true 


心 


Ship Order 





shipOrder 


XML representation 内 容 


定义 一 个 包含 网 关 需 要 一 行 XML : 


<inclusiveGateway id="myInclusiveGateway" /> 





名 


Archive order 







实际 的 行为 〈 分 支 ， 汇 聚 或 同时 分 支 汇聚 ) ， 是 由 连接 在 包含 网 关 的 顺序 流 决定 的 。 


参考 如 下 代码 : 


<startEvent id="thestart" /> 


<sequenceFlow id="flowi1" sourceRef="thestart" targetRef="fork" /> 


<inclusiveGateway id="fork" /> 
<sequenceFlow sourceRef="fork" targetRef="receivePayment" > 


<conditionExpression xsi:type="tFormalExpression">${paymentReceived == false}</conditionExpression> 
</sequenceFlow> 

<sequenceFlow sourceRef="fork" targetRef="shipOrder" > 

<conditionExpression xsi:type="tFormalExpression">${shipOrder == true}</conditionExpression> 
</sequenceFlow> 


<userTask id="receivePpayment" name="Receive Payment" /> 
<sequenceFlow sourceRef="receivePpayment" targetRef="join" /> 


<userTask id="shipOrder" name="Ship Order" /> 
<sequenceFlow sourceRef="shipOrder" targetRef="join" /> 


<inclusiveGateway id="join" /> 
<sequenceFlow sourceRef="join" targetRef="archiveOrder" /> 


<userTask id="archiveOrder" name="Archive Order" /> 
<sequenceFlow sourceRef="archiveOrder" targetRef="theEnd" /> 


<endEvent id="theEnd" /> 


在 上 面 的 例子 中 ， 流 程 开始 之 后 ， 如 果 流 程 变 量 为 paymentReceived == false 和 shipOrder == true， 


如 果 ， 只 有 一 个 流程 变量 为 true， 就 会 只 创建 一 个 任务 。 如 果 没 有 条 件 为 tue， 就 会 抛 出 一 个 异常 。 如 果 想 避 


定义 一 个 默认 顺序 流 。 下 面 的 例子 中 ， 会 创建 一 个 任务 ， 发 货 任 务 : 
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就 会 创建 两 个 任务 。 


异常 ， 可 以 
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HashMap<String, Object> variableMap = new HashMap<String, Object>(); 
variableMap.put("receivedpayment", true); 
variableMap.put("shipOrder", true); 
ProcessInstance pi = runtimeService.startProcessInstanceByKey("forkJoin"); 
TaskQuery query = taskService.createTaskQuery() 
.processInstanceId(pi.getId()) 
.orderByTaskName() 
aot 


List<Task> tasks = query.1ist(); 
assertEquals(1, tasks.size()); 


Task task = tasks.get(0); 
assertEquals("Ship Order", task.getName()); 


当 任 务 完 成 后 ， 第 二 个 包含 网 关 会 汇聚 两 个 分 支 ， 因为 只 有 一 个 外 出 顺序 流 ， 所 以 不 会 创建 并 行 分 支 ， 只 有 为 档 订 单 任务 会 
被 激活 。 


注意 ， 包 含 网 关 不 需要 “平衡 ”( 比 如， 对 应 包含 网 关 的 进入 和 外 出 数目 需要 相等 ) 。 包 含 网 关 会 等 待 所 有 进入 顺序 流 完成 ， 
并 为 每 个 外 出 顺序 流 创建 并 行 分 支 ， 不 会 受到 流程 中 其 他 元 素 的 影响 。 


Event-based Gateway 基于 事件 网 关 


Description 描述 


基于 事件 网 关 人 允许 根据 事件 判断 流向 。 网 关 的 每 个 外 出 顺序 流 都 要 连接 到 一 个 中 间 捕 获 事件 。 当 流 程 到 达 一 个 基于 事件 网 
关 ， 网 关 会 进入 等 待 状态 : 会 暂停 执行 。 与 此 同时 ， 会 为 每 个 外 出 顺序 流 创 建 相 对 的 事件 订阅 。 


注意 基于 事件 网 关 的 外 出 顺序 流 和 普通 顺序 流 不 同 。 这 些 顺 序 流 不 会 真 的 "执行 "。 相反 ， 它 们 让 流程 引擎 去 决定 执行 到 基于 
事件 网 关 的 流程 需要 订阅 哪些 事件 。 要 考虑 以 下 条 件 : 


e 基于 事件 网 关 必 须 有 两 条 或 以 上 外 出 顺序 流 。 
e@ 基于 事件 网 关 后 ， 只 能 使 用 intermediateCatchEvent 类 型 。 (activiti 不 支持 基于 事件 网 关 后 连接 ReceiveTask。 ) 
e@ 连接 到 基于 事件 网 关 的 intermediateCatchEvent 只 能 有 一条 进入 顺序 流 。 


Graphical notation 图 形 标记 


基于 事件 网 关 和 其 他 BPMN 网 关 一 样 显示 成 一 个 萎 形 ， 内 部 包含 指定 图 标 。 





XML representation 内 容 

用 来 定义 基于 事件 网 关 的 XML 元 素 是 eventBasedGateway。 

Example(s) 实例 

下 面 的 流程 是 一 个 使 用 基于 事件 网 关 的 例子 。 当 流程 执行 到 基于 事件 网 关 时 ， 流程 会 暂停 执行 。 与 此 同时 ， 流 程 实例 会 订阅 
警告 信号 事件 ， 并 创建 一 个 10 分 钟 后 触发 的 定时 器 。 这 会 产生 流程 引擎 为 一 个 信号 事件 等 待 10 分 钟 的 效果 。 如 果 10 分 钟 内 


发 出 信号 ， 定 时 器 就 会 取消 ， 流 程 会 治 着 信号 执行 。 如 果 信 号 没有 出 现 ， 流 程 会 治 着 定时 器 的 方向 前 进 ， 信 号 订阅 会 被 取 
消 。 
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Handle alert 


<definitions id="definitions" 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 
xmlns:activiti="http://activiti.org/bpmn" 
targetNamespace="Examples"> 


<signal id="alertSignal" name="alert" /> 


<process id="catchSignal"> 


</process> 
</definitions> 
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<startEvent id="start" /> 
<sequenceFlow sourceRef="start" targetRef="gwi" /> 
<eventBasedGateway id="gwi" /> 


<sequenceFlow sourceRef="gwi" targetRef="signalEvent" /> 
<sequenceFlow sourceRef="gwi" targetRef="timerEvent" /> 


<intermediateCatchEvent id="signalEvent" name="Alert"> 
<signalEventDefinition signalRef="alertSignal" /> 
</intermediateCatchEvent> 


<intermediateCatchEvent id="timerEvent" name="Alert"> 
<timerEventDefinition> 
<timeDuration>PT10M</timeDuration> 
</timerEventDefinition> 
</intermediateCatchEvent> 


<sequenceFlow sourceRef="timerEvent" targetRef="exGw1" /> 
<sequenceFlow sourceRef="signalEvent" targetRef="task" /> 


<userTask id="task" name="Handle alert"/> 
<exclusiveGateway id="exGw1" /> 


<sequenceFlow sourceRef="task" targetRef="exGw1" /> 
<sequenceFlow sourceRef="exGw1" targetRef="end" /> 


<endEvent id="end" /> 
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Tasks 任务 


User Task 用 户 任 务 


Description 描述 


用 户 任务 用 来 设置 必须 由 人 员 完 成 的 工作 。 当 流程 执行 到 用 户 任务 ， 会 创建 一 个 新 任务 ， 并 把 这 个 新 任务 加 入 到 分 配 人 或 群 
组 的 任务 列表 中 。 


Graphical notation 图 形 标记 


用 户 任务 显示 成 一 个 普通 任务 〈 圆 角 矩 形 ) ， 左 上 角 有 一 个 小 用 户 图 标 


人 


My Task 


XML representation 内 容 


XML 中 的 用 户 任务 定义 如 下 。id 属性 是 必须 的 。name 属性 是 可 选 的 。 
<USerTask id="theTask" name="Important task" /> 
用 户 任务 也 可 以 设置 描述 。 实 际 上 所 有 BPMN 2.0 元 素 都 可 以 设置 描述 。 添加 documentation 元 素 可 以 定义 描述 。 


<userTask id="theTask" name="Schedule meeting" > 
<documentation> 
Schedule an engineering meeting for next week with the new hire. 
</documentation> 


描述 文本 可 以 通过 标准 的 java 方 法 来 获得 : 


task.getDescription() 


Due Date 持续 时 间 

任务 可 以 用 一 个 字段 来 描述 任务 的 持续 时 间 。 可 以 使 用 查询 API 来 对 持续 时 间 进 行 搜 索 ， 根据 在 时 间 之 前 或 之 后 进行 搜索 。 
我 们 提供 了 一 个 节点 扩展 ， 在 任务 定义 中 设置 一 个 表达 式 ， 这 样 在 任务 创建 时 就 可 以 为 它 设置 初始 持续 时 间 。 表 达 式 应 该 是 
java.util.Date， java.util.String (ISO8601 格 式 )，ISO8601 持续 时 间 (比如 PT50M ) 或 null。 例如 : 你 可 以 在 流程 中 使 用 上 述 


格式 输入 日 期 ， 或 在 前 一 个 服务 任务 中 计算 一 个 时 间 。 这 里 使 用 了 持续 时 间 ， 持 续 时 间 会 基于 当前 时 间 进 行 计算 ， 再 通过 给 
定 的 时 间 段 累加 。 比如 ， 使 用 "PT30M'" 作 为 持续 时 间 ， 任 务 就 会 从 现在 开始 持续 30 分 钟 。 


<userTask id="theTask" name="Important task" activiti:dueDate="${datevariable}"/> 


User assignment 用 户 分 配 
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用 户 任务 可 以 直接 分 配给 一 个 用 户 。 这 可 以 通过 humanPerformer 元 素 定 义 。humanPerformer 定义 需要 一 个 
resourceAssignmentExpression 来 实际 定义 用 户 。 当前 ， 只 支持 formalExpressions。 


SpoOGBS SY va 


<userTask id='theTask' name='important task' > 
<humanPerformer> 
<resourceAssignmentExpression> 
<formalExpression>kermit</formalExpression> 
</resourceAssignmentExpression> 
</humanPerformer> 
</userTask> 


只 有 一 个 用 户 可 以 坐 拥 任务 的 执行 者 分 配给 用 户 。 在 activiti 中 ， 用 户 叫做 执行 者 。 拥有 执行 者 的 用 户 不 会 出 现在 其 他 人 的 
任务 列表 中 ， 只 能 出 现 执行 者 的 个 人 任务 列表 中 。 


直接 分 配给 用 户 的 任务 可 以 通过 TaskService 像 下 面 这 样 获取 : 


List<Task> tasks = taskService.createTaskQuery().taskAssignee("kermit").1ist(); 


任务 也 可 以 加 入 到 人 员 的 候选 任务 列表 中 。 这 时 ， 需 要 使 用 potentialOwner 元 素 。 用 法 和 humanPerformer 元 素 类 似 。 注 
意 它 需要 指定 表达 式 中 的 每 个 项 目 是 人 员 还 是 群 组 (引擎 猜 不 出 来 ) 。 





二 人 和 CS 


<userTask id='theTask' name='important task' > 
<potentialowner> 
<resourceAssignmentExpression> 
<formalExpression>user(kermit), group(management)</formalExpression> 
</resourceAssignmentExpression> 
</potentialOowner> 
</userTask> 


使 用 potential owner 元 素 定 义 的 任务 ， 可 以 像 下 面 这 样 获取 (使 用 TaskQuery 的 发 那个 发 与 查询 设置 了 执行 者 的 任务 类 
似 ) 


List<Task> tasks = taskService.createTaskQuery().taskCcandidateUser("kermit"); 


这 会 获取 所 有 kermit 为 候选 人 的 任务 ， 例如 : 表达 式 中 包含 user(kermit)。 这 也 会 获得 所 有 分 配 包含 kermit 这 个 成 员 的 群 组 
(比如 ，group(management)， 前 提 是 kermit 是 这 个 组 的 成 员 ， 并 且 使 用 了 activiti 的 账号 组 件 ) 。 用 户 所 在 的 群 组 是 在 运 
行 阶段 获取 的 ， 它 们 可 以 通过 IdentityService 进行 管理 。 


如 果 没 有 显示 指定 设置 的 是 用 户 还 是 群 组 ， 引 擎 会 默认 当做 群 组 处 理 。 所 以 下 面 的 设置 与 使 用 group(accountancy) 效果 一 
样 。 


<formalExpression>accountancy</formalExpression> 


Activiti extensions for task assignment 对 任务 分 配 的 扩展 


当 分 配 不 复杂 时 ， 用 户 和 组 的 设置 非常 麻烦 。 为 避免 复杂 性 ， 可 以 使 用 用 户 任务 的 自 定义 扩展 。 
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e assignee 属 性 : 这 个 自 定义 扩展 可 以 直接 把 用 户 任务 分 配给 指定 用 户 。 


它 和 使 用 上 面 定 义 的 humanPerformer 效果 完全 一 样 。 





e candidateUsers 属性 : 这 个 自 定义 扩展 可 以 为 任务 设置 候选 人 。 


它 和 使 用 上 面 定 义 的 potentialOwner 效果 完全 一 样 。 注意 它 不 需要 像 使 用 potential owner 通过 User(kermit) 声 明 ， 因为 这 个 
属性 只 能 用 于 人 员 。 





e candidateGroups 属性 : 这 个 自 定义 扩展 可 以 为 任务 设置 候选 组 。 


它 和 使 用 上 面 定 义 的 potentialOwner 效果 完全 一 样 。 注意 它 不 需要 像 使 用 potentialOwner 通过 group(management) 声明 ， 
因为 这 个 属性 只 能 用 于 群 组 。 





e candidateUsers 和 candidateGroups 可 以 同时 设置 在 同一 个 用 户 任务 中 。 


注意 : 虽然 activiti 提供 了 一 个 账号 管理 组 件 ， 也 提供 了 IdentityService， 但 是 账号 组 件 不 会 检测 设置 的 用 户 是 否 村 爱 。 它 
嵌入 到 应 用 中 ， 也 人 允许 activiti 与 其 他 已 存 的 账户 管理 方 案 集 成 。 








Custom identity link types (Experimental) 自 定 义 身 份 链接 类 型 (试验 ) 
[试验 ] 


BPMN 标准 支持 一 个 指定 的 用 户 或 humanperformer 或 一 组 用 户 ， 形 成 一 个 潜在 的 池 potentialowners 为 用 户 分 配 的 定义 。 
此 外 ，Activiti 定义 扩展 属性 的 元 素 ， 可 以 代表 任务 受 让 人 或 候选 人 的 所 有 者 的 用 户 任务 。 


支持 的 身份 链接 类 型 有 : 


public class IdentityLinkType { 
/* Activiti native roles */ 
public static final String ASSIGNEE = "assignee",; 
public static final String CANDIDATE = "candidate"; 
public static final String OWNER = "owner"; 
public static final String STARTER = "starter"; 
public static final String PARTICIPANT = "participant"; 


BPMN 标准 和 Activiti 实例 授权 身份 是 user (用 户 ) 和 group (组 ) 。 如 前 所 述 ，Activiti 身份 管理 的 实施 不 是 用 于 生产 使 
用 ， 但 应 扩展 取决 于 支持 授权 方案 。 





如 果 额 外 的 链接 类 型 是 必需 的 ， 自 定义 资源 可 以 被 定义 为 与 下 面 的 语法 扩展 元 素 : 


<userTask id="theTask" name="make profit"> 
<extensionElements> 
<activiti:customResource activiti:name="businessAdministrator"> 
<resourceAssignmentExpression> 
<formalExpression>user(kermit), group(management)</formalExpression> 
</resourceAssignmentExpression> 
</activiti:customResource> 
</extensionElements> 
</userTask> 


自 定义 链接 表达 式 添加 到 TaskDefinition 类 : 


protected Map<String, Set<Expression>> customUserIdentityLinkExpressions = 
new HashMap<String, Set<Expression>>(); 

protected Map<String, Set<Expression>> customGroupIdentityLinkExpressions = 
new HashMap<String, Set<Expression>>(); 
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public Map<String, 
Set<Expression>> getCustomUserIdentityLinkExpressions() { 
return customUserIdentityLinkExpressions; 


J» 


public void addCustomUserIdentityLinkExpression(String identityLinkType, 
Set<Expression> idList) { 
customUserIdentityLinkExpressions.put(identityLinkType, idList); 
b 


public Map<String, 
Set<Expression>> getCustomGroupIdentityLinkExpressions() { 


return customGroupIdentityLinkExpressions; 


} 
public void addCustomGroupIdentityLinkExpression(String identityLinkType, 
Set<Expression> idList) { 


customGroupIdentityLinkExpressions.put(identityLinkType, idList); 
上 


这 是 由 在 运行 时 的 UserTaskActivityBehavior handleAssignments 方法 落实 的 。 


最 后 ， 该 IdentityLinkType 类 必须 扩展 支持 自 定义 身份 链接 类 型 : 


package com.yourco.engine.task; 
public class IdentityLinkType 
extends org.activiti.engine.task.IdentityLinkType 
public static final String ADMINISTRATOR = "administrator"; 


public static final String EXCLUDED OWNER = "excludedOwner"; 


这 是 一 个 数据 库 实体 ， 包 含 了 自 定义 身份 链接 类 型 administrator 与 一 个 单一 的 用 户 (gonzo) 和 组 (engineering)。 


SELECT* FROM ACT_RU_IDENTITYLINK, 














IBDE IREYVS IISEROUP ED TYPE> USER_ ID_ |TASK_ID_ PROC_INST ID_|PROC:-DEF -ID _ 
899111 lnul |starter kermit no gg nl 
8995 1 null administratorl gonzo 8994 null null 
8996 1 null participant gonzo null 8989 null 
8997 1 | engineering |administrator| nu/l 18994 null null 


























Custom Assignment via task listeners 通过 任务 监听 器 自 定义 分 配 任务 


如 果 上 面 的 方式 还 不 满足 需求 ， 可 以 使 用 任务 监听 器 在 创建 事件 委托 自 定义 任务 逻辑 : 


<userTask id="task1i" name="My task" > 
<extensionElements> 


<activiti:taskListener event="create" class="org.activiti.MyAssignmentHandler" /> 
</extensionElements> 
</userTask> 


该 DelegateTask ， 传 递 到 TaskListener 的 实现 ， 人 允许 设置 的 受 让 人 和 候选 的 用 户 或 组 : 


public class MyAssignmentHandler implements TaskListener { 


public void notify(DelegateTask delegateTask) { 
// Execute custom identity lookups here 
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// and then for example call following methods : 
delegateTask.setAssignee("kermit"); 
delegateTask.addCcandidateUser ("fozzie"); 
delegateTask.addCandidateGroup("management"); 


使 用 spring 时 ， 可 以 使 用 向 上 面 章节 中 介绍 的 自 定义 分 配属 性 ， 使 用 表达 式 把 任务 监听 器 设置 为 spring 代理 的 bean， 
这 个 监听 器 监听 任务 的 创建 事件 。 下 面 的 例子 中 ， 执 行者 会 通过 调用 ldapService 这 个 spring bean 的 
findManagerOfEmployee 方法 获得 。 流程 变量 emp 会 作为 参数 传递 给 bean。 


<userTask id="task" name="My Task" activiti:assignee="${ldapService.findManagerForEmployee(emp)}"/> 
也 可 以 用 来 设置 候选 人 和 候选 组 : 

<userTask id="task" name="My Task" activiti:candidateUsers="${ldapService.findAllsales()}"/> 
注意 方法 返回 类 型 只 能 为 String 或 Collection (对 应 候选 人 和 候选 组 ) 


public class FakeLdapService { 


public String findManagerForEmployee(String employee) { 
return "Kermit The Frog"; 


用 


public List<String> findAllsales() { 
return Arrays.asList("kermit", "gonzo", "fozzie"); 


} 


Script Task 脚本 任务 

Description 描述 

脚本 任务 时 一 个 自动 节点 。 当 流程 到 达 脚本 任务 ， 会 执行 对 应 的 脚本 。 
Graphical notation 图 形 标记 


脚本 任务 显示 为 标准 BPMN 2.0 任务 〈 圆 角 矩 形 ) ， 左上 角 有 一 个 脚本 小 图 标 。 


号 


Execute script 





XML representation 内 容 


脚本 任务 定义 需要 指定 script 和 scriptFormat。 
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<ScriptTask id="thescriptTask" name="Execute script" scriptFormat="groovy"> 
<script> 
sum = 0 
for ( i in inputArray ) { 
Sum += i 
J 
</script> 
</scriptTask> 


scriptFormat 的 值 必须 兼容 JSR-223 (java 平台 的 脚本 语言 ) 。 默 认 Javascript 会 包含 在 JDK 中 ， 不 需要 额外 的 依赖 。 如 

果 你 想 使 用 其 他 (JSR-223 兼 容 ) 的 脚本 引擎 ， 需要 把 对 应 的 jar 添加 到 classpath 下 ， 并 使 用 合适 的 名 称 。 比 如 ，activiti 
单元 测试 经 常 使 用 groovy， 因为 语法 比 java 简单 太 多 。( 译 者 注 : 新 出 的 项 目 管 理工 具 Gradle 也 是 使 用 了 groovy, 详 见 
《Gradle 2 用 户 指南 》) 





注意 ，groovy 脚本 引擎 放 在 groovy-all.jar 中 。 在 2.0 版 本 之 前 ， 脚本 引擎 是 Groovy jar 的 一 部 分 。 这 样 ， 需 要 添加 如 下 依 
赖 : 


<dependency> 
<groupId>org.codehaus .groovy</groupId> 
<artifactId>groovy-all</artifactId> 
<version>2.x.x<version> 

</dependency> 


脚本 中 的 变量 


到 达 脚 本 任务 的 流程 可 以 访问 的 所 有 流程 变量 ， 都 可 以 在 脚本 中 使 用 。 实 例 中 ， 脚 本 变量 'inputArray' 其 实 是 流程 变量 (整数 
数组 ) 。 


<script> 
sum = 0 
for ( i in inputArray ) { 
Sum += I 


} 


</Script> 


也 可 以 在 脚本 中 设置 流程 变量 ， 直 接 调用 execution.setVariable("variableName",variableValue)。 默认 ， 不 会 自动 保存 变量 
(注意 : activiti 5.12 之 前 存在 这 个 问题 ) 。 可 以 在 脚本 中 自动 保存 任何 变量 。 (比如 上 例 中 的 sum ) ， 只 要 把 scriptTask 
的 autoStoreVariables 属性 设置 为 true。 然而 ， 最 佳 实践 是 不 要 用 它 ， 而 是 显示 调用 execution.setVariable()， 因为 一 些 当 

前 版 本 的 JDK 对 于 一 些 脚 本 语言 ， 无 法 实现 自动 保存 变量 。 参考 这 里 获得 更 多 信息 。 





<scriptTask id="script" scriptFormat="JavaScript" activiti:autoStorevariables="false"> 


参数 默认 为 false， 意 思 是 如 果 没 有 为 脚本 任务 定义 设置 参数 ， 所 有 声明 的 变量 将 只 存在 于 脚本 执行 的 阶段 。 


如 何在 脚本 中 设置 变量 的 例子 : 


<script> 
def scriptVar = "test123" 
execution.setVariable("myVar", scriptVar) 
</script> 


注意 : 下 面 这 些 命名 已 被 占用 ， 不 能 用 作 变 量 名 : : out, out:print, lang:import, context, elcontext 
Script results 脚本 结 
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脚本 任务 的 返回 值 可 以 通过 制定 流程 变量 的 名 称 ， 分 配给 已 存 或 一 个 新 流程 变量 ， 使 用 脚本 任务 定义 的 
'activiti:resultVariable' 属性 。 任何 已 存 的 流程 变量 都 会 被 脚本 执行 的 结果 履 盖 。 如 果 没 有 指定 返回 变量 名 ， 脚 本 的 返回 值 会 
被 忽略 。 











<ScriptTask id="thescriptTask" name="Execute script" scriptFormat="juel" activiti:resultVariable="myVar"> 
<script>#{echo}</script> 
</scriptTask> 


上 例 中 ， 脚 本 的 结果 (表达 式 '#{echo} 的 值 ) 在 脚本 完成 后 ， 会 设置 到 'myVar 变量 中 。 
Java Service Task 服务 任务 

Description 描述 

Java 服务 任务 用 来 调用 外 部 Java 类 

Graphical notation 图 形 标记 


服务 任务 显示 为 圆 角 矩形 ， 左 上 角 有 一 个 齿轮 小 图 标 


My Java 


Service Task 





XML representation 内 容 
有 4 钟 方法 来 声明 java 调用 远 辑 : 


e@ 实现 JavaDelegate 或 ActivityBehavior 
e 执行 解析 代理 对 象 的 表达 式 

e。 调用 一 个 方法 表达 式 

e 调用 一 直 值 表达 式 


执行 一 个 在 流程 执行 中 调用 的 类 ， 需要 在 'activiti:class' 属 性 中 设置 全 类 名 。 


<serviceTask id="javaService" 
name="My Java Service Task" 
activiti:class="org.activiti.MyJavaDelegate" /> 


NR 


考 实现 章节 了 解 更 多 使 用 类 的 信息 


也 可 以 使 用 表达 式 调用 一 个 对 象 。 对 象 必须 遵循 一 些 规 则 ， 并 使 用 activiti:class 属性 进行 创建 。 (了 解 更 多 ) 。 


<serviceTask id="serviceTask" activiti:delegateExpression="${delegateExpressionBean}" /> 


这 里 ，delegateExpressionBean 是 一 个 实现 了 JavaDelegate 接口 的 bean， 它 定义 在 实例 的 spring 容器 中 。 
要 指定 执行 的 UEL 方法 表达 式 ， 需要 使 用 activiti:expression。 
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<serviceTask id="javaService" 
name="My Java Service Task" 
activiti:expression="#{printer.printMessage()}" /> 


方法 printMessage (无 参数 ) 会 调用 名 为 printer 对 象 的 方法 。 也 可 以 为 表达 式 中 的 方法 传递 参数 。 


<serviceTask id="javaService" 
name="My Java Service Task" 
activiti:expression="#{printer.printMessage(execution, myVar)}" /> 


这 会 调用 名 为 printer 对 象 上 的 方法 printMessage。 第 一 个 参数 是 DelegateExecution， 在 表达 式 环境 中 默认 名 称 为 
execution。 第 二 个 参数 传递 的 是 当前 流程 的 名 为 myVar 的 变量 。 


要 指定 执行 的 UEL 值 表达 式 ， 需要 使 用 activiti:expression 属性 。 


<serviceTask id="javaService" 
name="My Java Service Task" 
activiti:expression="#{split.ready}" /> 


ready 属性 的 getter 方法 ，getReady (无 参数 ) ， 会 作用 于 名 为 split 的 bean 上 。 这 个 对 象 会 被 解析 为 流程 对 象 和 (如 果 
合适 ) Spring 环境 中 的 对 象 。 


Implementation 实现 


要 在 流程 执行 中 实现 一 个 调用 的 类 ， 这 个 类 需要 实现 org.activiti.engine.delegate.JavaDelegate 接口 ， 并 在 execute 方法 中 
提供 对 应 的 业务 逻辑 。 当 流 程 执 行 到 特定 阶段 ， 它 会 指定 方法 中 定义 好 的 业务 逻辑 ， 并 按照 默认 BPMN 2.0 中 的 方式 离开 
节点 。 让 我 们 创建 一 个 java 类 的 例子 ， 它 可 以 流程 变量 中 字符 串 转 换 为 大 写 。 这 个 类 需要 实现 
org.activiti.engine.delegate.JavaDelegate 接口 ， 这 要 求 我 们 实现 execute(DelegateExecution) 方法 。 它 包含 的 业务 逻辑 会 
被 引 警 调用。 流程 实例 信息 ， 如 流程 变量 和 其 他 信息 ， 可 以 通过 DelegateExecution 接 口 访问 和 操作 (点 击 对 应 操作 的 
javadoc 的 链接 ， 获 得 更 多 信息 ) 。 


public class ToUppercase implements JavaDelegate { 


public void execute(DelegateExecution execution) throws Exception { 
String var = (String) execution.getVariable("input"); 
var = var.toUpperCase(); 
execution.setVariable("input", var); 


了 


注意 : serviceTask 定义 的 class 只 会 创建 一 个 java 类 的 实例 。 所 有 流程 实例 都 会 共享 相同 的 类 实例 ， 并 调用 
execute(DelegateExecution)。 这 意味 着 ， 类 不 能 使 用 任何 成 员 变 量 ， 必 须 是 线程 安全 的 ， 它 必须 能 模拟 在 不 同 线程 中 执 
行 。 这 也 影响 着 属性 注入 的 处 理 方 式 。 


流程 定义 中 引用 的 类 (上 比如， 使 用 activiti:class ) 不 会 在 部 署 时 实例 化 。 只 有 当 流 程 第 一 次 执行 到 使 用 类 的 时 候 ， 类 的 实例 
才 会 被 创建 。 如 果 找 不 到 类 ， 会 抛 出 一 个 ActivitiException。 这 个 原因 是 部 署 环境 〈 更 确切 是 的 classpath ) 和 真实 环境 往往 
是 不 同 的 。 比如 当 使 用 ant 或 业务 娄 档 上 传 到 Activiti Explorer 来 发 布 流程 classpath 没有 包含 引用 的 类 。 


[内 部 : 非 公共 实现 类 ] 也 可 以 提供 实现 org.activiti.engine.impl.pvm.delegate.ActivityBehavior 接口 的 类 。 实现 可 以 访问 更 强 


大 的 ActivityExecution, 它 可 以 影响 流程 的 流向 。 注 意 ， 这 不 是 一 个 很 好 的 实践 ， 应 该 尽量 避免 。 所 以 ， 建 议 只 有 在 高 级 情 
况 下 并 且 你 确切 知道 你 要 做 什么 的 情况 下 ， 再 使 用 ActivityBehavior 接口 。 
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Field Injection 属性 注入 





可 以 为 代理 类 的 属性 注 和 数据。 支持 如 下 类 型 的 注入 : 





如 果 有 效 的 话 ， 数 值 会 通过 代理 类 的 setter 方 法 注入 ， 遵 循 java bean 的 命名 规范 (比如 fistName 属性 对 应 setFirstName(…) 
方法 ) 。 如 果 属 性 没有 对 应 的 setter 方法 ， 数 值 会 直接 注入 到 私有 属性 中 。 一 些 环境 的 SecurityManager 不 允许 修改 私有 

属性 ， 所 以 最 好 还 是 把 你 想 注 入 的 属性 暴露 出 对 应 的 setter 方法 来 。 无 论 流程 定义 中 的 数据 是 什么 类 型 ， 注 入 目标 的 属性 类 
型 都 应 该 是 org.activiti.engine.delegate.Expression。 














下 面 代 码 演 示 了 如 何 把 一 个 常量 注入 到 属性 中 。 属性 注入 可 以 使 用 'class' 属性 。 注意 我 们 需要 定义 一 
个 'extensionElements' XML 元 素 ， 在 声明 实际 的 属性 注入 之 前 ， 这 是 BPMN 2.0 XML 格式 要 求 的 。 


<serviceTask id="javaService" 
name="Java service invocation" 
activiti:class="org.activiti.examples.bpmn.servicetask.ToUpperCaseFieldInjected"> 
<extensionElements> 
<activiti:field name="text" stringValue="Hello World" /> 
</extensionElements> 
</serviceTask> 


ToUpperCaseFieldlnjected 类 有 一 个 text 属性 ， 类 型 是 org.activiti.engine.delegate.Expression。 调用 
text.getValue(execution) 时 ， 会 返回 定义 的 字符 串 Hello World。 


也 可 以 使 用 长 文字 (比如 ， 内 嵌 的 email) ， 可 以 使 用 'activiti:string' 子 元 素 : 


<serviceTask id="javaService" 
name="Java service invocation" 
activiti:class="org.activiti.examples.bpmn.servicetask.ToUpperCaseFieldInjected"> 
<extensionElements> 
<activiti:field name="text"> 
<activiti:string> 
Hello World 
</activiti:string> 
</activiti:field> 
</extensionElements> 
</serviceTask> 


可 以 使 用 表达 式 ， 实 现在 运行 期 动态 解析 注入 的 值 。 这 些 表 达 式 可 以 使 用 流程 变量 或 spring 定义 的 bean (如 果 使 用 了 
spring ) 。 像 服务 任务 实现 里 说 的 那样 ， 服 务 任务 中 的 java 类 实例 会 在 所 有 流程 实例 中 共享 。 为 了 动态 注入 属性 的 值 ， 我 们 
可 以 在 org.activiti.engine.delegate.Expression 中 使 用 值 和 方法 表达 式 ， 它 会 使 用 传递 给 execute 方法 的 DelegateExecution 
参数 进行 解析 。 





<serviceTask id="javaService" name="Java service invocation" 
activiti:class="org.activiti.examples.bpmn.servicetask.ReverseStringsFieldInjected"> 


<extensionElements> 
<activiti:field name="text1"> 
<activiti:expression>${genderBean.getGenderString(gender)}</activiti:expression> 
</activiti:field> 
<activiti:field name="text2"> 
<activiti:expression>Hello ${gender == 'male' ? 'Mr.' : 'Mrs.'} ${name}</activiti:expression> 
</activiti:field> 
</ extensionElements> 
</ serviceTask> 


下 面 的 例子 中 ， 注 入 了 表达 式 ， 并 使 用 在 传 入 的 当前 DelegateExecution 解 析 它 们 。 完整 代码 可 以 参考 
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org.activiti.examples.bpmn.servicetask.JavaServiceTaskTest.testExpressionFieldlnjection。 


public class ReverseStringsFieldInjected implements JavaDelegate { 


private Expression text1， 
private Expression text2; 


public void execute(DelegateExecution execution) { 
String valuel1 = (String) text1.getValue(execution); 
execution.setVariable("var1", new StringBuffer(value1).reverse().tostring()); 


String value2 = (String) text2.getValue(execution); 
execution.setVariable("var2", new StringBuffer(value2).reverse().tostring()); 
} 


另外 ， 你 也 可 以 把 表达 式 设置 成 一 个 属性 ， 而 不 是 字 元 素 ， 让 XML 更 简单 一 些 。 


<activiti:field name="text1i" expression="${genderBean.getGenderstring(gender)}" /> 
<activiti:field name="text1i" expression="Hello ${gender == "male’ 2? 'Mr." : 'Mrs.'} ${name}" /> 





因为 java 类 实例 会 被 重用 ， 注 入 只 会 发 生 一 次 ， 当 服务 任务 调用 第 一 次 的 时 候 。 当 你 的 代码 中 的 属性 改变 了 ， 值 也 不 会 重 
新 注入 ， 所 以 你 应 该 把 它们 看 做 是 不 变 的 ， 不 用 修改 它们 。 


Service task results 服务 任务 结 


服务 流程 返回 的 结果 (使 用 表达 式 的 服务 任务 ) 可 以 分 配给 已 经 存在 的 或 新 的 流程 变量 ， 可 以 通过 指定 服务 任务 定义 的 
'activiti:resultVariable' 属性 来 实现 。 指定 的 路 程 比 那 两 的 值 会 被 服务 流程 的 返回 结果 履 盖 。 如 果 没 有 指定 返回 变量 名 ， 就 会 
忽略 返回 结果 。 


<serviceTask id="aMethodExpressionServiceTask" 
activiti:expression="#{myService.doSsomething()}" 
activiti:resultVariable="myVar" /> 


在 上 面 的 例子 中 ， 服 务 流程 的 返回 值 (在 'myService' 上 调用 'doSomething()' 方法 的 返回 值 ， myService 可 能 是 流程 变量 ， 
也 可 能 是 spring 的 bean ) ， 会 设置 到 名 为 ,myVar 的 流程 变量 里 ， 在 服务 执行 完成 之 后 。 


Handling exceptions 人 处 理 异常 
执行 自 定义 逻辑 时 ， 常 常 需要 捕获 对 应 的 业务 异常 ， 在 流程 内 部 进行 处 理 。 activiti 提供 了 不 同 的 方式 来 处 理 这 个 问题 
Throwing BPMN Errors 抛 出 BPMN Errors 


可 以 在 服务 任务 或 脚本 任务 的 代码 里 抛 出 BPMN error。 为 了 实现 这 个 ， 要 从 JavaDelegate， 脚 本 ， 表 达 式 和 代理 表达 式 中 
抛 出 名 为 BpmnError 的 特殊 ActivitiExeption。 引擎 会 捕获 这 个 异常 ， 把 它 转发 到 对 应 的 错误 处 理 中 。 上 比如 ， 边 界 错误 事件 或 
错误 事件 子 流程 。 


public class ThrowBpmnErrorDelegate implements JavaDelegate { 


public void execute(DelegateExecution execution) throws Exception { 
ry 
executeBusinessLogic(); 
} catch (BusinessException e) { 
throw new BpmnError("BusinessExceptionOoccurred"); 
} 
} 
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构造 参数 是 错误 代码 ， 会 被 用 来 决定 哪个 错误 处 理 器 会 来 响应 这 个 错误 。 参考 边界 错误 事件 获得 更 多 捕获 BPMN error 的 


信息 。 


这 个 机 制 应 该 只 用 于 业务 失败 ， 它 应 该 被 流程 定义 中 设置 的 边界 错误 事件 或 错误 事件 子 流程 处 理 。 技 术 上 的 错误 应 该 使 用 其 
他 异常 类 型 ， 通 常 不 会 在 流程 里 处 理 。 


Exception Sequence Flow 异常 顺序 流 


[内 部 ， 公 开 实 现 类 ] 另 一 种 选择 是 在 一 些 异常 发 生 时 ， 让 路 程 进入 其 他 路 径 。 下 面 的 代码 演示 了 如 何 实现 。 


<serviceTask id="javaService" 
name="Java service invocation" 
activiti:class="org.activiti.ThrowsExceptionBehavior"> 
</serviceTask> 


<sequenceFlow id="no-exception" sourceRef="javaService" targetRef="theEnd" /> 
<sequenceFlow id="exception" sourceRef="javaService" targetRef="fixException" /> 


这 里 的 服务 任务 有 两 个 外 出 顺序 流 ， 分 别 叫 exception 和 no-exception 。 异 常 出 现时 会 使 用 顺序 流 的 id 来 决定 流向 


public class ThrowsExceptionBehavior implements ActivityBehavior { 


public void execute(ActivityExecution execution) throws Exception { 
String var = (String) execution.getVvariable("var"); 


PvmTransition transition = null; 
try { 
executeLogic(var); 
transition = execution.getActivity().findoutgoingTransition("no-exception"); 
} catch (Exception e) { 
transition = execution.getActivity().findOoutgoingTransition("exception"); 


有 


execution.take(transition) 





Using an Activiti service from within a JavaDelegate 在 JavaDelegate 里 使 用 
activiti 服务 


一 些 场景 下 ， 需 要 在 java 服务 任务 中 使 用 activiti 服务 (比如 ， 通 过 RuntimeService 启动 流程 实例 ， 而 callActivity 不 满足 


你 的 需求 ) 。 org.activiti.engine.delegate.DelegateExecution 人 允许 通过 org.activiti.engine.EngineServices 接口 直接 获得 这 
些 服 务 : 


public class StartProcessInstanceTestDelegate implements JavaDelegate { 


public void execute(DelegateExecution execution) throws Exception { 
RuntimeService runtimeService = execution.getEngineServices().getRuntimeService(); 
runtimeService.startProcessInstanceByKey("myProcess"); 


» 


所 有 activiti 服务 的 API 都 可 以 通过 这 个 接口 获得 。 


使 用 这 些 API 调用 出 现 的 所 有 数据 改变 ， 都 是 在 当前 事务 中 的 。 在 像 spring 和 CDI 这 样 的 依赖 注入 环境 也 会 起 作用 ， 无 论 是 
否 启 用 了 JTA 数据 源 。 比如 ， 下 面 的 代码 功能 与 上 面 的 代码 一 致 ， 这 是 RuntimeService 是 通过 依赖 注入 获得 的 ， 而 不 是 通 
过 org.activiti.engine.EngineServices 接口 。 
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@Component ("startProcessInstanceDelegate") 
public class StartProcessInstanceTestDelegatewithInjection { 


@Autowired 
private RuntimeService runtimeService; 


public void startProcess() { 
runtimeService.startProcessInstanceByKey("oneTaskProcess"); 


} 


重要 技术 提示 : 因为 服务 调用 是 在 当前 事务 里 ， 数据 的 产生 或 改变 ， 在 服务 任务 执行 完 之 前 ， 还 没有 提交 到 数据 库 。 所 有 
API 对 于 数据 库 数据 的 操作 ， 意 味 着 未 提交 的 操作 在 服务 任务 的 API 调用 中 都 是 不 可 见 的 


Web Service Task 

[试验 ] 

Description 描述 

Web Service 任 务 可 以 用 来 同步 调用 一 个 外 部 的 Web service。 
Graphical notation 图 形 标记 


Web Service 任务 与 Java 服 务 任务 显示 效果 一 样 。 





XML representation 内 容 


要 使 用 Web Service 我 们 需要 导入 它 的 操作 和 类 型 。 可 以 自动 使 用 import 标签 来 指定 Web Service 的 WSDL : 


<import importType="http://schemas.xmlsoap.org/wsdl1/" 
location="http://localhost:63081/counter?wsd1" 
namespace="http://webservice.activiti.org/" /> 


上 面 的 声明 告诉 activiti 导入 WSDL 定义 ， 但 没有 创建 item 定义 和 消息 。 假设 我 们 想 调 用 一 个 名 为 'prettyPrint' 的 方法 ， 我 
们 必须 创建 为 请 求 和 响应 信息 对 应 的 消息 和 item 定义 : 


<message id="prettyPrintCountRequestMessage" itemRef="tns:prettyPrintCountRequestItem" /> 
<message id="prettyPrintCountResponseMessage" itemRef="tns:prettyPrintCountResponseItem" /> 


<itemDefinition id="prettyPrintCountRequestItem" structureRef="counter:prettyPrintCount" /> 
<itemDefinition id="prettyPrintCountResponseItem" structureRef="counter:prettyPrintCountResponse" /> 


在 申请 服务 任务 之 前 ， 我 们 必须 定义 实际 引用 Web Service 的 BPMN 接口 和 操作 。 基本 上 ， 我 们 定义 接口 和 必要 的 操作 。 
对 每 个 奥 做 我 们 都 会 重用 上 面 定义 的 信息 作为 输入 和 输出 。 比如 ， 下 面 定义 了 'counter 接口 和 'prettyPrintCountOperation' 
操作 : 
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<interface name="Counter Interface" implementationRef="counter:Counter"> 
<operation id="prettyPrintCountOperation" name="prettyPrintCount Operation" 
implementationRef="counter:prettyPrintCount"> 
<inMessageRef>tns:prettyPrintCountRequestMessage</inMessageRef> 
<outMessageRef>tns:prettyPrintCountResponseMessage</outMessageRef> 
</operation> 
</interface> 


然后 我 们 可 以 定义 Web Service 任务 使 用 ##WebService 实现 ， 并 引用 Web Service 操作 。 


<serviceTask id="webService" 
name="Web service invocation" 
implementation="##WebService" 
operationRef="tns:prettyPrintCountOperation"> 


Web Service Task IO Specification 规范 


除非 我 们 使 用 简化 方式 处 理 数据 输入 和 输出 关联 (如 下 所 示 ) ， 每 个 Web Service 任务 可 以 定义 任务 的 输入 输出 IO 规范 。 
配置 方式 与 BPMN 2.0 完全 兼容 ， 下 面 格式 化 后 的 例子 ， 我 们 根据 之 前 定义 item 定义 ， 定 义 了 输入 和 输出 。 


<ioSpecification> 
<dataInput itemSubjectRef="tns:prettyPrintCountRequestItem" id="dataInputofServiceTask" /> 
<data0utput itemSubjectRef="tns:prettyPrintCountResponseItem" id="dataOutputofServiceTask" /> 
<inputSet> 
<dataInputRefs>dataInputofServiceTask</dataInputRefs> 
</inputSet> 
<OutputSet> 
<data0utputRefs>data0utputofServiceTask</data0utputRefs> 
</outputSet> 
</ioSpecification> 


Web Service Task data input associations 任务 数据 输入 关联 
有 两 种 方式 指定 数据 输入 关联 : 


。 使 用 表达 式 
。 使 用 简化 方式 





要 使 用 表达 式 指定 数据 输入 关联 ， 我 们 需要 定义 来 源 和 目的 item， 并 指定 每 个 item 属性 之 间 的 对 应 关系 。 下 面 的 例子 中 我 
们 分 配 了 这 些 item 的 前 级 和 后 级 : 


<dataInputAssociation> 
<sourceRef>dataInputofProcess</sourceRef> 
<targetRef>dataInputofServiceTask</targetRef> 
<assignment> 
<from>${dataInputofProcess.prefix}</from> 
<to>${dataInputofServiceTask.prefix}</to> 
</assignment> 
<assignment> 
<from>${dataInputofProcess.suffix}</from> 
<to>${dataInputofServiceTask.suffix}</to> 
</assignment> 
</dataInputAssociation> 








另外 ， 我 们 可 以 使 用 更 简单 的 简化 方式 。'sourceRef 元 素 是 activiti 的 变量 名 ，'targetRef 元 素 是 item 定义 的 一 个 属性 。 在 
下 面 的 例子 中 ， 我 们 把 'PrefixVariable' 变量 的 值 分 配给 field' 属性 ， 把 'SuffixVariable' 变量 的 值 分 配给 'suffix' 属性 。 





Tasks 任务 131 














Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 





<dataInputAssociation> 
<SOourceRef>PrefixVariable</sourceRef> 
<targetRef>prefix</targetRef> 
</dataInputAssociation> 
<dataInputAssociation> 
<sourceRef>Suffixvariable</sourceRef> 
<targetRef>suffix</targetRef> 
</dataInputAssociation> 


Web Service Task data output associations 任务 数据 输出 关联 
有 两 种 方式 指定 数据 输出 关联 : 


。 使 用 表达 式 
。 使 用 简化 方式 





要 使 用 表达 式 指 定数 据 输出 关联 ， 我 们 需要 定义 目的 变量 和 来 源 表 达 式 。 方法 和 数据 输入 关联 完全 一 样 : 


<data0utputAssociation> 
<targetRef>data0utputofProcess</targetRef> 
<transformation>${dataOutputofServiceTask.prettyPrint}</transformation> 
</data0utputAssociation> 





另外 ， 我 们 可 以 使 用 更 简单 的 简化 方式 。'sourceRef 元 素 是 item 定义 的 一 个 属性 ，'targetRef 元 素 是 activiti 的 变量 名 。 方 
法 和 数据 输入 关联 完全 一 样 : 


<data0utputAssociation> 
<sourceRef>prettyPrint</sourceRef> 
<targetRef>0utputVariable</targetRef> 

</data0utputAssociation> 


Business Rule Task 业务 规则 任务 

[试验 ] 

Description 描述 

业务 规则 用 户 用 来 同步 执行 一 个 或 多 个 规则 。activiti 使 用 drools 规则 引擎 执行 业务 规则 。 目 前 ， 包 含 业务 规则 的 .drl 文件 必 
须 和 流程 定义 一 起 发 布 ， 流 程 定义 里 包含 了 执行 这 些 规则 的 业务 规则 任务 。 意 味 着 流程 使 用 的 所 有 .drl 文 件 都 必须 打包 在 流程 
BAR 文 件 里 ， 上 比如 任务 表单 。 更 多 使 用 Drools Expert 创建 业务 规则 的 信息 ， 请 参考 JBoss Drools 的 文档 。 如 果 想 要 使 用 你 


的 规则 任务 的 实现 ， 上 比如 ， 因 为 你 想 用 不 同方 式 使 用 drools， 或 你 想 使 用 完全 不 同 的 规则 引擎 ， 你 可 以 使 用 
BusinessRuleTask 上 的 class 或 表达 式 属性 ， 它 用 起 来 就 和 ServiceTask 一 样 。 


Graphical notation 图 形 标记 
业务 规则 任务 使 用 一 个 表格 小 图 标 进行 显示 。 


下 


Executea | 
Business Rule 





XML representation 内 容 
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要 执行 部 署 流程 定义 的 BAR 文件 中 的 一 个 或 多 个 业务 规则 ， 我 们 需要 定义 输入 和 输出 变量 。 对 于 输入 变量 定义 ， 可 以 使 用 
过 号 分 隔 的 一 些 流程 变量 。 输出 变量 定义 智能 包含 一 个 变量 名 ， 它 会 把 执行 业务 规则 后 返回 的 对 象 保存 到 对 应 的 流程 变量 
中 。 注意 ， 结 果 变 量 会 包含 一 个 对 象 列表 。 如 果 没 有 指定 输出 变量 名 称 ， 默 认 会 使 用 org.activiti.engine.rules.OUTPUT。 
下 面 的 业务 规则 任务 会 执行 和 流程 定义 一 起 部 署 的 素 有 业务 规则 : 

<process id="simpleBusinessRuleProcess"> 


<startEvent id="thestart" /> 
<sequenceFlow sourceRef="thestart" targetRef="businessRuleTask" /> 


<businessRuleTask id="businessRuleTask" activiti:ruleVariablesInput="${order}" 
activiti:resultVariable="rulesOutput" /> 


<sequenceFlow sourceRef="businessRuleTask" targetRef="theEnd" /> 
<endEvent id="theEnd" /> 


</process> 
业务 规则 任务 也 可 以 配置 成 只 执行 部 署 的 .drl 文件 中 的 一 些 规则 。 这 时 要 设置 逗号 分 隔 的 规则 名 。 


<businessRuleTask id="businessRuleTask" activiti:ruleVariablesInput="${order}" 
activiti:rules="rulei, rule2" /> 


这 时 ， 只 会 执行 rulel 和 rule2。 


你 也 可 以 定义 哪些 规则 不 用 执行 。 


<businessRuleTask id="businessRuleTask" activiti:ruleVvariablesInput="${order}" 
activiti:rules="rule1i, rule2" exclude="true" /> 


这 时 除了 rulel 和 rule2 以 外 ， 所 有 部 署 到 流程 定义 同一 个 BAR 文 件 中 的 规则 都 会 执行 。 
像 之 前 提 到 的 ， 可 以 用 一 个 选项 修改 BusinessRuleTask 的 实现 : 


注意 BusinessRuleTask 的 功能 和 ServiceTask 一 样 ， 但 是 我 们 使 用 BusinessRuleTask 的 图 标 来 表示 我 们 在 这 里 要 执行 业务 
规则 。 


Email Task 

activiti 强化 了 业务 流程 ， 支 持 了 自动 邮件 任务 ， 它 可 以 发 送 邮 件 给 一 个 或 多 个 参与 者 ， 包括 支持 cc, bcc, HTML 内 容 等 等 。 
注意 邮件 任务 不 是 BPMN 2.0 规范 定义 的 官方 任务 。 ( 它 也 没有 对 应 的 图 标 ) 。 因此 ，activiti 中 邮件 任务 是 用 专门 的 服务 
任务 实现 的 。 

Mail server configuration 邮件 服务 器 配置 


activiti 引擎 要 通过 支持 SMTP 功 能 的 外 部 邮件 服务 器 发 送 邮件 。 为 了 实际 发 送 邮 件 ， 引 警 需 要 知道 如 何 访问 邮件 服务 器 。 下 
面 的 配置 可 以 设置 到 activiti.cfg.xml 配置 文件 中 : 


Table 8.1. Mail server configuration 


属性 是 否 需要 ? 描述 
mailServerHost no mail 服 务 器 名 称 (如 mail.mycorp.com). 默认 是 localhost 
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mailServerPort 


mailServerDefaultFrom 


mailServerUsername 


mailServerPassword 


mailServerUseSSL 


mailServerUseTLS 
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yes, 但 不 是 在 邮件 服务 器 上 的 SMTP 传 输 端 口 。 默 认为 25 





默认 端口 

如 果 用 户 没 有 指定 发 送 邮件 的 邮件 地 址 ， 默 认 设 置 的 发 送 者 的 邮件 地 
址 。 默 认为 activiti@activiti.org 

7 一 些 邮 件 服务 器 需要 认证 才能 发 送 邮 件 。 默 认 不 设置 。 

a 一 些 邮 件 服务 器 需要 认证 才能 发 送 邮 件 。 默 认 不 设置 。 

ST 一 些 邮件 服务 器 需要 ss| 交 互 。 默 认为 false。 

Tn 一 些 邮件 服务 器 (比如 gmail) 需要 支持 TLS。 默 认为 false。 





Defining an Email Task 定义 


邮件 任务 是 一 个 专用 的 服务 任务 ， 


这 个 服务 任务 的 type 设 置 为 'mail'。 


<serviceTask id="sendMail" activiti:type="mail"> 





邮件 任务 是 通过 属性 注入 进行 配置 的 。 所 有 这 些 属性 都 可 以 使 用 EL 表达 式 ， 可 以 在 流程 执行 中 解析 。 


置 : 


Table 8.2. Mail task configuration 


属性 


to 

from 
Subject 
CC 

bcc 
charset 


html 


text 


htmlVar 


textVar 
ignoreException 


exceptionVariableName 


Example usage 使 用 实例 


下 面 的 XML 演示 了 使 用 邮件 任务 的 例子 


Tasks 任务 


no 


no 


no 


no 


no 


描 六 


学 


瑟 


Eh 件 的 接受 者 。 可 以 使 用 至 号 分 隔 多 个 接受 者 

邮件 发 送 者 的 地 址 。 如 果 不 提 供 ， 会 使 用 默认 配置 的 地 址 
邮件 的 主题 

F 件 抄 送 人 。 可 以 使 用 逗号 分 隔 多 个 接收 者 

邮件 上 暗 送 人 。 可 以 使 用 逗号 分 隔 多 个 接收 者 

可 以 修改 邮件 的 字符 集 ， 对 很 多 非 英 语 语言 是 必须 设置 的 。 


孔 





作为 邮件 内 容 的 HTML 


邮件 的 内 容 ， 在 需要 使 用 原始 文 字 ( 非 富 文本 ) 的 邮件 时 使 用 。 可 以 与 html 一 起 
使 用 ， 对 于 不 支持 富 客 户 端的 邮件 客户 端 。 客户 端 会 降级 到 仅 显 示 文 本 的 方式 。 


使 用 对 应 的 流程 变量 作为 e-mail 的 内 容 。 它 和 html 的 不 同 之 处 是 它 内 容 中 包含 的 
表达 式 会 在 mail 任务 发 送 之 前 被 替换 掉 。 


下 面 的 属性 都 可 以 设 


使 用 对 应 的 流程 变量 作为 e-mail 的 纯 文本 内 容 。 它 和 html 的 不 同 之 处 是 它 内 容 中 


包含 的 表达 式 会 在 mail 任 务 发 送 之 前 被 替换 掉 
处 理 邮 件 失败 时 ， 是 否 忽略 异常 ， 不 抛 出 ActivitiException， 默 认为 false。 


当 设置 了 ignoreException =true 处 理 email 时 不 抛 出 异常 ， 可 以 指定 一 个 变量 名 
来 存储 失败 信息 。 


134 

















Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 


<serviceTask id="sendMail" activiti:type="mail"> 
<extensionElements> 
<activiti:field name="from" stringValue="order-shipping@thecompany.com" /> 
<activiti:field name="to" expression="${recipient}" /> 
<activiti:field name="subject" expression="Your order ${orderId} has been shipped" /> 
<activiti:field name="html"> 
<activiti:expression> 
<![CDATA[ 
<html> 
<body> 
Hello ${male ? "Mr." : 'Mrs.' } ${recipientName},<br/><br/> 


As of ${now}, your order has been <b>processed and shipped</b>.<br/><br/> 
Kind regards,<br/> 


TheCompany. 
</body> 
</html> 
J> 
</activiti:expression> 
</activiti:field> 


</extensionElements> 
</serviceTask> 
结果 如 下 : 
File Edit View Message Utilities Help 


Subject : Your order 123456 has been shipped 
Date : September 24, 2010 1:23:04 PM 


From : ordershippingaactiviti.org 
To : johndoefoalfresco.com 


Hello Mr. John Doe, 


As of Fri Sep 24 13:23:04 CEST 2010, your order has been processed and shipped. 


Kind regards, 
TheCompany. 


Mule Task 


mule 任务 可 以 向 mule 发 送 消息 ， 以 强化 activiti 的 集成 能 力 。 注 意 mule 任务 不 是 BPMN 2.0 规范 定义 的 官方 任务 。 它 也 没有 
对 应 的 图 标 ) 。 因此 ，activiti 中 mule 任务 是 用 专门 的 服务 任务 实现 的 。 


Defining an Mule Task 定义 


mule 任务 是 一 个 专用 的 服务 任务 ， 这 个 服务 任务 的 type 设置 为 'mule'。 


<serviceTask id="sendMule" activiti:type="mule"> 
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mule 任务 是 通过 属性 注入 进行 配置 的 。 所 有 这 些 属 性 都 可 以 使 用 EL 表达 式 ， 可 以 在 流程 执行 中 解析 。 下 面 的 属性 都 可 以 
设置 : 


Table 8.3. Mule server configuration 


属性 是 否 需要 ? 描述 
endpointUnl yes 望 调用 的 Mule 终 端 
language yes 你 要 使 用 解析 荷载 表达 式 (payloadExpression) 属性 的 语言 
payloadExpression yes 作为 消息 荷载 的 表达 式 。 
resultVariable no 将 要 保存 调用 结果 的 变量 名 称 


Example usage 应 用 实例 


下 面 是 一 个 使 用 mule 任务 的 例子 


<extensionElements> 

<activiti:field name="endpointUr1"> 
<activiti:string>vm://in</activiti:string> 

</activiti:field> 

<activiti:field name="language"> 
<activiti:string>juel</activiti:string> 

</activiti:field> 

<activiti:field name="payloadExpression"> 
<activitisstring> ha </activiti:string> 

</activiti:field> 

<activiti:field name="resultVariable"> 
<activiti:string>theVvariable</activiti:string> 

</activiti:field> 

</extensionElements> 








Camel Task 


Camel 任务 可 以 从 Camel 发 送 和 介绍 消息 ， 由 此 强化 了 activiti 的 集成 功能 。 注意 camel 任务 不 是 BPMN 2.0 规范 定义 的 官 
方 任务 。 ( 它 也 没有 对 应 的 图 标 ) 。 在 activiti 中 ，camel 任务 时 由 专用 的 服务 任务 实现 的 。 要 使 用 camel 任务 功能 时 ， 也 
要 记得 吧 activiti camel 包含 到 项 目 里 。 





Defining a Camel Task 定义 


camel 任务 是 一 个 专用 的 服务 任务 ， 这 个 服务 任务 的 type 设 置 为 “camel。 


<serviceTask id="sendCamel" activiti:type="camel"> 


流程 定义 只 需要 在 服务 任务 中 定义 camel 类 型 。 集成 逻辑 都 会 代理 给 camel 容器 。 默 认 activiti 引擎 会 在 spring 容器 中 查找 
camelContext bean。 camelContext 定义 了 camel 容器 加 载 的 路 由 规则 。 下 面 的 例子 中 路 由 规则 是 从 指定 的 java 包 下 加 载 
的 。 但 是 你 也 可 以 通过 spring 配置 直接 定义 路 由 规则 。 


<camelContext id="camelContext" xmlns="http://camel.apache.org/schema/spring"> 
<packageScan> 
<package>org.activiti.camel.route</package> 
</packageScan> 
</camelContext> 


如 果 想 了 解 更 多 关于 camel 路 由 的 信息 ， 可 以 访问 Camel 的 网 站 在 这 里 只 通过 很 小 的 例子 演示 了 基础 的 概念 。 在 第 一 个 例 
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子 中 ， 我 们 会 通过 activiti 工作 流 实现 最 简单 的 Camel 调 用 。 我 们 称 其 为 SimpleCamelCall。 


如 果 想 定义 多 个 Camel 环境 bean， 并 且 (或 者 ) 想 使 用 不 同 的 bean 名 称 ， 可 以 重 载 CamelTask 的 定义 ， 如 下 所 示 : 


<serviceTask id="serviceTask1" activiti:type="camel"> 
<extensionElements> 
<activiti:field name="camelContext" stringValue="customCamelContext" /> 
</extensionElements> 
</serviceTask> 


Simple Camel Call example 简单 Camel 调 用 


这 个 例子 对 应 的 文件 都 可 以 在 activiti camel 模块 的 org.activiti.camel.examples.simpleCamelCall 包 下 找到 。 我 们 的 目标 是 
简单 激活 一 个 特定 的 camel 路 由 。 首先 ， 我 们 需要 一 个 Spring 环境 ， 它 要 包含 之 前 介绍 的 路 由 。 这 些 文件 的 目的 如 下 : 








<CamelContext id="camelContext" xmlns="http://camel.apache.org/schema/spring"> 
<packageScan> 
<package>org.activiti.camel.examples.simpleCamelCcall</package> 
</packageScan> 
</came1Context> 





包含 名 为 SimpleCamelCallRoute 的 路 由 的 类 文件 ， 放 在 PackageScan 标 签 的 扫描 目录 下 。 下 面 就 是 路 由 的 定义 : 


public class SimpleCamelCallRoute extends RouteBuilder { 


@override 
public void configure() throws Exception { 
from("activiti:SimpleCamelCallProcess:simpleCall").to("log:org.activiti.camel.examples.SimpleCamelCall"); 
上 
由 


这 个 规则 仅仅 打印 消息 体 ， 不 会 做 其 他 事情 。 注 意 终端 的 格式 。 它 包含 三 部 分 : 


Table 8.4. Endpoint URL parts: 


Endpoint Url 部 分 描述 
activiti 引用 Activiti endpoint 
SimpleCamelCallProcess 进程 名 字 
simpleCall 流程 中 的 Camel 服务 


OK， 我 们 的 规则 已 经 配置 好 ， 也 可 以 让 Camel 使 用 了 。 现在 看 工作 流 部 分 。 工 作 流 看 起 来 像 这 


<process id="SimpleCamelCallProcess"> 
<startEvent id="start"/> 
<sequenceFlow id="flow1" sourceRef="start" targetRef="simpleCall"/> 


<serviceTask id="simpleCall" activiti:type="camel"/> 
<sequenceFlow id="flow2" sourceRef="simpleCall" targetRef="end"/> 


<endEvent id="end"/> 
</process> 


在 serviceTask 部 分 ， 它 只 注 明 服务 的 类 型 是 Camel， 目 标 规则 名 为 simpleCall。 这 与 上 面 的 activiti 终端 相 匹配 。 初 始 化 流 
程 后 ， 我 们 会 看 到 一 个 空 的 日 志 。 好 ， 我 们 已 经 完成 了 这 个 最 简单 的 例子 了 
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Ping Pong example 乒乓 实例 


我 们 的 例子 成 功 执行 了 ， 但 是 Camel 和 Activiti 之 间 没 有 任何 交互 ， 而 且 这 样 做 也 没有 任何 优势 。 在 这 个 例子 里 ， 我 们 尝试 
向 Camel 发 送 和 接收 数据 。 我 们 发 送 一 个 字符 串 ，camel 进行 一 些 处 理 ， 然 后 返回 结果 。 发送 部 分 很 科 单 ， 我 们 把 变量 里 
的 消息 发 送 给 camel。 这 里 是 我 们 的 调用 代码 


@Deployment 
public void testPingPong() { 
Map<String, Object> variables = new HashMap<String, Object>(); 


variables.put("input", "Hello"); 
Map<String, String> outputMap = new HashMap<String, String>(); 
variables.put("outputMap", outputMap); 


runtimeService.startProcessInstanceByKey("PingPongProcess", variables); 
assertEquals(1, outputMap.size()); 
assertNotNull(outputMap.get("outputValue")); 

assertEquals("Hello World", outputMap.get("outputValue")); 


变量 "input" 是 Camel 规则 的 实际 输入 ，outputMap 会 记录 camel 返回 的 结果 。 流 程 应 该 像 是 这 样 : 


0 


<process id="PingPongProcess"> 
<startEvent id="start"/> 
<sequenceFlow id="flow1" sourceRef="start" targetRef="ping"/> 
<serviceTask id="ping" activiti:type="camel"/> 
<sequenceFlow id="flow2" sourceRef="ping" targetRef="saveOutput"/> 
<serviceTask id="saveOutput" activiti:class="org.activiti.camel.examples.pingPong.SaveOutput" /> 
<sequenceFlow id="flow3" sourceRef="saveOutput" targetRef="end"/> 
<endEvent id="end"/> 
</process> 


注意 ，SaveOuput 这 个 serviceTask， 会 把 "Output" 变 量 的 值 从 上 下 文保 存 到 上 面 提 到 的 OutputMap 中 。 现在 ， 我 们 必须 了 
解 变量 是 如 何 发 送 给 Camel， 再 返回 的 。 这 里 就 要 涉及 到 camel 实际 执行 的 行为 了 。 变量 提交 给 camel 的 方法 是 由 
CamelBehavior 控制 的 。 这 里 我 们 使 用 默认 的 配置 ， 其 他 的 会 在 后 面 提 及 。 使 用 这 些 代码 ， 我 们 就 可 以 配置 一 个 期 望 的 
camel 行为 : 


<serviceTask id="serviceTask1" activiti:type="camel"> 


<extensionElements> 
<activiti:field name="camelBehaviorClass" stringValue="org.activiti.camel.impl.CamelBehaviorCamelBodyImpl" /> 
</extensionElements> 
</serviceTask> 
如 果 你 没有 特别 指定 一 个 行为 ， 就 会 使 用 org.activiti.camel.impl.CamelBehaviorDefaultImpl。 这 个 行为 会 把 变量 复制 成 名 称 





相同 的 Camel 属性 。 在 返回 时 ， 无 论 选择 什么 行为 ， 如 果 camel 消息 体 是 一 个 map， Re es 个 变量 ， 否则 
整个 对 象 会 复制 到 指定 名 称 为 "camelBody" 的 变量 中 。 了 解 这 些 后 ， 就 可 以 看 看 我 们 第 二 个 例子 的 camel 规则 了 : 


Q@override 
public void configure() throws Exception { 
from("activiti:PingPongProcess:ping").transform().simple("${property.input} World"); 


在 这 个 规则 中 ， 字 符 串 "world" 会 被 添加 到 "input" 属 性 的 后 面 ， 结 果 会 写 入 消息 体 。 这 时 可 以 检查 javaServiceTask 中 

的 "camelBody" 变 量 ， 复 制 到 "outputMap'" 中 ， 并 在 testcase 进行 判断 。 现 在 这 个 例子 是 在 默认 的 行为 下 运行 的 ， 然 后 我 们 看 
0 在 启动 的 所 有 camel 规则 中 ， 流 程 实例 id 会 复制 到 camel 的 名 为 "PROCESS_ID_PROPERTY" 的 属性 
中 。 后 续 可 以 用 它 关 联 流程 实例 和 camel 规则 。 他 也 可 以 在 camel 规 则 中 直接 使 用 。 
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Activiti 中 可 以 使 用 三 种 不 同 的 行为 。 这 些 行为 可 以 通过 在 规则 URL 中 指定 对 应 的 环节 来 实现 履 盖 。 这 里 有 一 个 在 URL 中 才 盖 
现存 行为 的 例子 : 








from("activiti:asyncCamelProcess:serviceTaskAsync2?copyVariablesToProperties=true"). 


下 面 的 表格 提供 了 三 种 camel 行为 的 概述 : 


Table 8.5. Existing camel behaviours: 





行为 Url 描述 
CamelBehaviorDefaultImpl copyVariablesToProperties 复制 Activiti 属性 作为 Camel 属性 
i 
CamelBehaviorCamelBodylmpl copyCamelBodyToBody ed camelBody Activiti 变 量 复制 成 camel 
JI 相 局 


iviti 扑 万 | 恋 时 人 交 
CamelBehaviorBodyAsMaplmpl copyVariablesToBodyAsMap 外 六 map 里 ， 作 为 
ME 


上 面 的 表格 解释 和 activiti 变量 如 何 传递 给 camel。 下 面 的 表格 解释 和 camel 的 变量 如 何 返 回 给 activiti。 它 只 能 配置 在 规则 
URL 中 。 


Table 8.6. Existing camel behaviours: 


Url 描述 


如 果 Camel 消 息 体 是 一 个 map， 把 每 个 元 素 复 制 成 activiti 的 变量 ， 否 则 把 整 


Default 个 camel 消 息 体 作 为 activiti 的 "camelBody" 变 量 。 
copyVariablesFromProperties 将 Camel 属 性 以 相同 名 称 复 制 为 Activiti 变 量 


和 默认 一 样 ， 但 是 如 果 camel 消 息 体 不 是 map 时 ， 先 把 它 转 换 成 字符 串 ， 再 


copyCamelBodyToBodyAsString 设置 为 "camelBody 
又 Y o 


copyVariablesFromHeader 额外 把 camel 头 部 以 相同 名 称 复制 成 Activiti 变 量 
例子 的 源码 放 在 activiti-camel 模块 的 org.activiti.camel.examples.pingPong 包 下 。 
Asynchronous Ping Pong example 异步 乒 丘 实例 


之 前 的 例子 都 是 同步 的 。 流 程 会 等 到 camel 规则 返回 之 后 才 会 停止 。 一 些 情况 下 ， 我 们 需要 activiti 工作 流 继续 运行 。 这 时 
camelServiceTask 的 异步 功能 就 特别 有 用 。 你 可 以 通过 设置 camelServiceTask 的 async 属性 来 启用 这 个 功能 。 

















<serviceTask id="serviceAsyncPing" activiti:type="camel" activiti:async="true"/> 


通过 设置 这 个 功能 ，camel 规则 会 被 activiti 的 jobExecutor 异步 执行 。 当 你 在 camel 规则 中 定义 了 一 个 队列 ，activiti 流程 
会 在 camelServiceTask 执行 时 继续 运行 。 camel 规则 会 以 完全 异步 的 方式 执行 。 如 果 你 想 在 什么 地 方 等 待 
camelServiceTask 的 返回 值 ， 你 可 以 使 用 一 个 receiveTask。 


<receiveTask id="receiveAsyncPing" name="Wait State" /> 


流程 实例 会 等 到 接收 一 个 signal， 上 比如 来 自 camel。 在 camel 中 你 可 以 发 送 一 个 signal 给 流程 实例 ， 通 过 对 应 的 activiti 终端 
发 送 消 息 


from("activiti:asyncPingProcess:serviceAsyncPing").to("activiti:asyncPingProcess:receiveAsyncPing"); 
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对 于 一 个 常用 的 终端 ， 会 使 用 冒号 分 隔 的 三 个 部 分 : 
e 常量 字符 串 "activiti" 


。 流程 名 称 
。 接收 任务 名 


Instantiate workflow from Camel route 从 camel 规 则 中 实例 化 工作 流 


之 前 的 所 有 例子 中 ，activiti 工作 流 会 先 启动 ， 然 后 在 流程 中 启动 camel 规则 。 也 可 以 使 用 另外 一 种 方法 。 在 已 经 启动 的 
camel 规则 中 启动 一 个 工作 流 。 这 会 触发 一 个 receiveTask 十 分 类 似 ， 除 了 最 后 的 部 分 。 这 是 一 个 实例 规则 : 


from("direct:start").to("activiti:camelProcess"); 


我 们 看 到 url 有 两 个 部 分 ， 第 一 个 部 分 是 常量 字符 串 "activit"， 第 二 部 分 是 流程 的 名 称 。 很 明星， 流程 应 该 已 
且 是 可 以 启动 的 。 


也 可 以 设置 流程 发 起 人 到 Camel 头 提供 的 身份 验证 的 用 户 ID 。 为 了 实现 这 个 ， 发 起 人 变量 必须 在 流程 定义 中 指定 的 : 


<startEvent id="start" activiti:initiator="initiator" /> 
接着 用 户 Id 包含 在 Camel 头 名 字 叫 CamelProcesslnitiatorHeader ， 定 义 如 下 


from("direct:startwithInitiatorHeader") 
.SetHeader ("CamelProcessInitiatorHeader", constant("kermit")) 
.to("activiti:InitiatorCamelCallProcess?processInitiatorHeaderName=CamelProcessInitiatorHeader"); 


Manual Task 手工 任务 


Description 描述 


手工 任务 定义 了 BPM 引擎 外 部 的 任务 。 用 来 表示 工作 需要 某 人 完成 ， 而 引擎 不 需要 知道 ， 也 没有 对 应 的 系统 和 UI 接口 。 


对 于 引擎 ， 手 工 任务 是 直接 通过 的 活动 ， 流程 到 达 它 之 后 会 自动 向 下 执行 。 


Graphical notation 图 形 标记 


手工 任务 显示 为 一 个 圆 角 和 矩形， 左上 角 是 一 个 手 型 小 图 标 。 


Es 


Call client for 


more information 





XML representation 内 容 


<manualTask id="myManualTask" name="Call client for more information" /> 
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Java Receive Task 


Description 描述 


接收 任务 是 一 个 简单 任务 ， 它 会 等 待 对 应 消息 的 到 达 。 当 前 ， 我 们 只 实现 了 这 个 任务 的 java 语义 。 当 流 程 达 到 接收 任务 ， 
流程 状态 会 保存 到 存储 里 。 意味 着 流程 会 等 待 在 这 个 等 待 状态 ， 直到 引擎 接收 了 一 个 特定 的 消息 ， 这 会 触发 流程 穿 过 接收 
任务 继续 执行 。 





Graphical notation 图 形 标记 


接收 任务 显示 为 一 个 任务 〈 圆 角 和 矩形 ) ， 右 上 角 有 一 个 消息 小 标记 。 消 息 是 白色 的 (黑色 图 标 表示 发 送 语义 ) 


wait 


XML representation 内 容 


<receiveTask id="waitState" name="wait" /> 


要 在 接收 任务 等 待 的 流程 实例 继续 执行 ， 可 以 调用 runtimeService.signal(executionld)， 传递 接收 任务 上 流程 的 id。 下 面 的 
代码 演示 了 实际 是 如 何 工作 的 : 


ProcessInstance pi = runtimeService.startPprocessInstanceByKey("receiveTask"); 
Execution execution = runtimeService.createExecutionQuery() 
.processInstanceId(pi.getId()) 
.activityId("waitState") 
.SingleResult(); 
assertNotNull(execution); 


runtimeService.signal(execution.getId()); 


Shell Task 

Description 描述 

shell 任 务 可 以 执行 shell 脚 本 和 命令 。 注意 shell 任务 不 是 BPMN 2.0 规范 定义 的 官方 任务 。 ( 它 也 没有 对 应 的 图 标 ) 。 
defining a shell task 定义 


shell 任 务 是 一 个 专用 的 服务 任务 ， 这 个 服务 任务 的 type 设 置 为 'Shel 


<serviceTask id="shellEcho" activiti:type="shell"> 


shell 任务 使 用 属性 注入 进行 配置 。 所 有 属性 都 可 以 包含 EL 表达 式 ， 会 在 流程 执行 过 程 中 解析 。 可 以 配置 以 下 属性 : 


Table 8.7. Shell task parameter configuration 
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属性 是 否 需 要 ? Type 描述 默认 
command yes String 执行 的 shell 命 兮 
arg0-5 no String 参数 0 至 5 
wait no true/false 是 否 需 要 等 待 到 shell 进 程 结束 true 
redirectError no true/false 标准 错误 与 标准 输出 合并 false 
cleanEnv no true/false shell 进 行 不 继承 当前 环境 false 
outputVariable no String 包含 输出 变量 名 称 输出 不 记录 
errorCodeVariable no String 包含 结果 错误 代码 的 变量 名 会 注册 错误 级 别 
directory no String shell 进 程 的 默认 目录 当前 目录 


Example usage 应 用 实例 


下 面 的 代码 演示 了 使 用 shell 任务 的 实例 。 它 会 执行 shell 脚本 "cmd /c echo EchoTest"， 等 到 它 结束 ， 再 把 输出 结果 保存 到 
resultVar 中 。 


<serviceTask id="shellEcho" activiti:type="shell" > 
<extensionElements> 
<activiti:field name="command" stringValue="cmd" /> 
<activiti:field name="arg1" stringValue="/c" /> 
<activiti:field name="arg2" stringValue="echo" /> 
<activiti:field name="arg3" stringValue="EchoTest" /> 
<activiti:field name="wait" stringValue="true" /> 
<activiti:field name="outputVariable" stringValue="resultVar" /> 
</extensionElements> 
</serviceTask> 


Execution listener 执行 监听 器 


兼容 性 提醒 : 在 发 布 5.3 后 ， 我 们 发 现 执 行 监听 器 ， 任务 监听 器 ， 表 达 式 还 是 非 公开 API。 这 些 类 在 
org.activiti.engine.impl... 的 子 包 ， 包 名 中 有 一 个 impl。 org.activiti.engine.impl.pvm.delegate.ExecutionListener, 
org.activiti.engine.impl.pvm.delegate.TaskListener 和 org.activiti.engine.impl.pvm.el.Expression 已 经 废弃 了 。 从 现在 开始 ， 
应 该 使 用 org.activiti.engine.delegate.ExecutionListener, org.activiti.engine.delegate.TaskListener 和 
org.activiti.engine.delegate.Expression。 在 新 的 公开 API 中 ， 删 除了 ExecutionListenerExecution.getEventSource()。 因为 
已 经 设置 了 废弃 编译 警告 ， 所 以 已 存 的 代码 应 该 可 以 正常 运行 。 但 是 要 考虑 切换 到 新 的 公共 API 接 口 〈 包 名 中 没有 .impl.) 。 


执行 监听 器 可 以 执行 外 部 java 代码 或 执行 表达 式 ， 当 流程 定义 中 发 生 了 某 个 事件 。 可 以 捕获 的 事件 有 : 
e@ 流程 实例 的 启动 和 结 
e@ 选中 一 条 连 线 。 
e 节点 的 开始 和 结 
e 网 关 的 开始 和 结 


e 中 间 事 件 的 开始 和 结 
e 开始 时 间 结 束 或 结束 事件 开始 。 


下 面 的 流程 定义 包含 了 3 个 流程 监听 器 : 


<process id="executionListenersProcess"> 
<extensionElements> 
<activiti:executionListener class="org.activiti.examples.bpmn.executionlistener.ExampleExecutionListenerOne" ever 


</extensionElements> 


<startEvent id="thestart" /> 
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<sequenceFlow sourceRef="theSstart" targetRef="firstTask" /> 


<userTask id="firstTask" /> 
<sequenceFlow sourceRef="firstTask" targetRef="secondTask"> 
<extensionElements> 
<activiti:executionListener class="org.activiti.examples.bpmn.executionListener.ExampleExecutionListenerTwo" /> 
</extensionElements> 
</sequenceFlow> 


<userTask id="secondTask" > 
<extensionElements> 
<activiti:executionListener expression="${myPojo.myMethod(execution.event)}" event="end" /> 
</extensionElements> 
</userTask> 
<sequenceFlow sourceRef="secondTask" targetRef="thirdTask" /> 


<userTask id="thirdTask" /> 
<sequenceFlow sourceRef="thirdTask" targetRef="theEnd" /> 


<endEvent id="theEnd" /> 


</process> 
一 = 一 一 一 一 一 一 一 一 一 二 


第 一 个 流程 监听 器 监听 流程 开始 。 监 听 器 是 一 个 外 部 java 类 ( 像 是 ExampleExecutionListenerOne) ， 需要 实现 
org.activiti.engine.delegate.ExecutionListener 接口 。 当 事 件 发 生 时 (这 里 是 end 事件 ) ， 会 调用 
notify(ExecutionListenerExecution execution) 方法 。 





public class ExampleExecutionListenerOne implements ExecutionListener { 


public void notify(ExecutionListenerExecution execution) throws Exception { 
execution.setVariable("variableSetInExecutionListener", "firstValue"); 
execution.setVariable("eventReceived", execution.getEventName()); 

} 


也 可 以 使 用 实现 org.activiti.engine.delegate.JavaDelegate 接口 的 代理 类 。 代理 类 可 以 在 结构 中 重用 ， 比 如 serviceTask 的 
代理 。 


第 二 个 流程 监听 器 在 连 线 执行 时 调用 。 注 意 这 个 listener 元 素 不 能 定义 event， 因为 连 线 只 能 触发 take 事件 。 为 连 线 定义 的 
监听 器 的 event 属 性 会 被 忽略 。 


最 后 一 个 流程 监听 器 在 节点 secondTask 结束 时 调用 。 这 里 使 用 expression 代替 class 来 在 事件 触发 时 执行 /调用 。 


<activiti:executionListener expression="${myPojo.myMethod(execution.eventName)}" event="end" /> 
和 其 他 表达 式 一 样 ， 流 程 变量 可 以 处 理 和 使 用 。 因 为 流程 实现 对 象 有 一 个 保存 事件 名 称 的 属性 ， 可 以 在 方法 中 使 用 
execution.eventName 获 的 事件 名 称 。 


流程 监听 器 也 支持 使 用 delegateExpression, 和 服务 任务 相同 。 


<activiti:executionListener event="start" delegateExpression="${myExecutionListenerBean}" /> 


在 activiti 5.12 中 ， 我 们 也 介绍 了 新 的 流程 监听 器 ， org.activiti.engine.impl.bpmn.listener.ScriptExecutionListener。 这 个 脚 
本 流程 监听 器 可 以 为 某 个 流程 监听 事件 执行 一 段 脚本 。 


<activiti:executionListener event="start" class="org.activiti.engine.impl.bpmn.listener.ScriptExecutionListener" > 
<activiti:field name="script"> 
<activiti:string> 
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def bar = "BAR"; // local variable 
foo = "FO00"; // pushes variable to execution context 
execution.setVariable("vari", "test"); // test access to execution instance 
bar // implicit return value 
</activiti:string> 

</activiti:field> 

<activiti:field name="language" stringVvalue="groovy" /> 

<activiti:field name="resultVariable" stringValue="myVar" /> 

<activiti:executionListener> 


Field injection on execution listeners 流程 监听 器 的 属性 注 


使 用 流程 监听 器 时 ， 可 以 配置 class 属 性 ， 可 以 使 用 属性 注入。 这 和 使 用 服务 任务 属性 注入 相同 ， 参考 它 可 以 获得 属性 注入 的 
很 多 信息 。 





下 面 的 代码 演示 了 使 用 了 属性 注入 的 流程 监听 器 的 流程 的 简单 例子 。 


<process id="executionListenersProcess"> 
<extensionElements> 
<activiti:executionListener class="org.activiti.examples.bpmn.executionListener .ExampleFieldInjectedExecutionList 
<activiti:field name="fixedValue" stringValue="Yes, I am " /> 
<activiti:field name="dynamicValue" expression="${myVar}" /> 
</activiti:executionListener> 
</extensionElements> 


<startEvent id="theSstart" /> 
<sequenceFlow sourceRef="thestart" targetRef="firstTask" /> 


<userTask id="firstTask" /> 
<sequenceFlow sourceRef="firstTask" targetRef="theEnd" /> 


<endEvent id="theEnd" /> 
</process> 


一 





public class ExampleFieldInjectedExecutionListener implements ExecutionListener { 
private Expression fixedValue; 
private Expression dynamicValue; 


public void notify(ExecutionListenerExecution execution) throws Exception { 
execution.setVariable("var", fixedValue.getValue(execution).toString() + dynamicVvalue.getValue(execution).toStr 





ExampleFieldlnjectedExecutionListener 类 串联 了 两 个 注入 的 属性 。 (一 个 是 固定 的 ， 一 个 是 动态 的 ) ， 把 他 们 保存 到 流程 
变量 var 中 。 


@Dpeployment(resources = {"org/activiti/examples/bpmn/executionListener/ExecutionListenersFieldInjectionprocess.bpmn20.> 
public void testExecutionListenerFieldInjection() { 

Map<String, Object> variables = new HashMap<String, Object>(); 

variables.put("myVar", "listening!"); 


ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("executionListenersProcess", variables); 
Object varSetByListener = runtimeService.getVariable(processInstance.getId(), "var"); 
assertNotNull(varSetByListener); 


assertTrue(varSetByListener instanceof String); 


// Result is a concatenation of fixed injected field and injected expression 
assertEquals("Yes, I am listening!", varSetByListener); 
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吕 一 一 一 


Task listener 任务 监听 器 





任务 监听 器 可 以 在 发 生 对 应 的 任务 相关 事件 时 执行 自 定义 java 逻辑 或 表达 式 。 


任务 监听 器 只 能 添加 到 流程 定义 中 的 用 户 任 务 中 。 注意 它 必 须 定 义 在 BPMN 2.0 extensionElements 的 子 元 素 中 ， 并 使 用 
activiti 命名 空间 ， 因 为 任务 监听 器 是 activiti 独 有 的 结构 。 


<userTask id="myTask" name="My Task" > 
<extensionElements> 
<activiti:taskListener event="create" class="org.activiti.MyTaskCreateListener" /> 
</extensionElements> 
</userTask> 


任务 监听 器 支持 以 下 属性 : 


e event ( 必 选 ) : 任务 监听 器 会 被 调用 的 任务 类 型 。 可 能 的 类 型 为 : 
create : 任务 创建 并 设置 所 有 属性 后 触发 。 
o assignment : 任务 分 配给 一 些 人 时 触发 。 当 流 程 到 达 userTask， assignment 事 件 会 在 create 事 件 之 前 发 生 。 这 样 
的 顺序 似乎 不 自然 ， 但 是 原因 很 简单 : 当 获 得 create 时 间 时 ， 我 们 想 获得 任务 的 所 有 属性 ， 包 括 执 行人 。 
o complete : 当 任务 完成 ， 并 尚未 从 运行 数据 中 删除 时 触发 。 
o delete : 只 在 任务 删除 之 前 发 生 。 注意 在 通过 completeTask 正 常 完 成 时 ， 也 会 执行 。 
e class : 必须 调用 的 代理 类 。 这 个 类 必须 实现 org.activiti.engine.delegate.TaskListener 接口 。 


Le 


public class MyTaskCreateListener implements TaskListener { 


public void notify(DelegateTask delegateTask) { 
// Custom logic goes here 


h 


可 以 使 用 属性 注入 把 流程 变量 或 执行 传递 给 代理 类 。 注 意 代理 类 的 实例 是 在 部 署 时 创建 的 (和 activiti 中 其 他 类 代理 的 情况 一 
样 ) ， 这 意味 着 所 有 流程 实例 都 会 共享 同一 个 实例 。 


e。 expression : (无 法 同时 与 class 属性 一 起 使 用 ) : 指定 事件 发 生 时 执行 的 表达 式 。 可 以 把 DelegateTask 对 象 和 事件 
名 称 ( 使 用 task.eventName ) 作为 参数 传递 给 调用 的 对 象 。 


<activiti:taskListener event="create" expression="${myObject.callMethod(task, task.eventName)}" /> 


e delegateExpression 可 以 指定 一 个 表达 式 ， 解 析 一 个 实现 了 TaskListener 接口 的 对 象 ， 这 与 服务 任务 一 致 。 


<activiti:taskListener event="create" delegateExpression="${myTaskListenerBean}" /> 


e 在 activiti 5.12 中 ， 我 们 也 介绍 了 新 的 任务 监听 器 ，org.activiti.engine.impl.bpmn.listener.ScriptTaskListener。 脚本 任 
务 监听 器 可 以 为 任务 监听 器 事件 执行 脚本 。 


<activiti:taskListener event="complete" class="org.activiti.engine.impl.bpmn.listener.ScriptTaskListener" > 
<activiti:field name="script"> 
<actmvitistnring> 
def bar = "BAR"; // local variable 
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foo = "FO00"; // pushes variable to execution context 
task.setOwner("kermit"); // test access to task instance 
bar // implicit return value 
</activitd string> 
</activiti:field> 
<activiti:field name="language" stringValue="groovy" /> 
<activiti:field name="resultVariable" stringValue="myVar" /> 
<activiti:taskListener> 


Multi-instance (for each) 多 实例 (循环 ) 


Description 描述 


多 实例 节点 是 在 业务 流程 中 定义 重复 环节 的 一 个 方法 。 从 开发 角度 讲 ， 多 实例 和 循环 是 一 样 的 : 它 可 以 根据 给 定 的 集合 ， 为 
每 个 元 素 执 行 一 个 环节 甚至 一 个 完整 的 子 流程 ， 既 可 以 顺序 依次 执行 也 可 以 并 发 同步 执行 。 


多 实例 是 在 一 个 普通 的 节点 上 添加 了 额外 的 属性 定义 (所 以 叫做 ' 多 实例 特性 ') ， 这 样 运行 时 节点 就 会 执行 多 次 。 下 面 的 节 
点 都 可 以 成 为 一 个 多 实例 节点 


e@ User Task 

e@ Script Task 

e@ Java Service Task 

e@ Web Service Task 

e Business Rule Task 

e Email Task 

e Manual Task 

e Receive Task 

e (Embedded) Sub-Process 
e Call Activity 


网 关 和 事件 不 能 设置 多 实例 。 

根据 规范 的 要 求 ， 每 个 上 级 流程 为 每 个 实例 创建 分 支 时 都 要 提供 如 下 变量 : 
e nroOflnstances : 实例 总 数 
e nrOfActivelnstances : 当前 活动 的 ， 比 如 ， 还 没完 成 的 ， 实 例 数 量 。 对 于 顺序 执行 的 多 实例 ， 值 一 直 为 1。 
e nrOfCompletedlnstances : 已 经 完成 实例 的 数目 。 


e 可 以 通过 execution.getVariable(x) 方法 获得 这 些 变量 。 另外 ， 每 个 创建 的 分 支 都 会 有 分 支 级 别 的 本 地 变量 〈 比 如 ， 其 他 
实例 不 可 见 ， 不 会 保存 到 流程 实例 级 别 ) 


e loopCounter : 表示 特定 实例 的 在 循环 的 索引 值 。 可 以 使 用 activiti 的 elementlndexVariable 属性 修改 loopCounter 的 变 
量 名 。 


Graphical notation 图 形 标记 


如 果 节 点 是 多 实例 的 ， 会 在 节点 底部 显示 三 条 短线 。 三 条 坚 线 表示 实例 会 并 行 执 行 。 三 条 横 线 表示 顺序 执行 。 


名 


MI user task MI service call 





XML representation 内 容 
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要 把 一 个 节点 设置 为 多 实例 ， 节 点 Xml 元素 必须 设置 一 个 multilnstanceLoopCharacteristics 子 元 素 


<multiInstanceLoopCharacteristics isSequential="false|true"> 


</multiInstanceLoopCharacteristics> 





isSequential 属性 表示 节点 是 进行 顺序 执行 还 是 并 行 执行 。 实 例 的 数量 会 在 进入 节点 时 计算 一 次 。 有 一 些 方法 配置 它 。 一 种 
方法 是 使 用 loopCardinality 子 元 素 直 接 指定 一 个 数字 。 


<multiInstanceLoopCharacteristics isSequential="false|true"> 
<loopCardinality>5</loopCardinality> 
</multiInstanceLoopCharacteristics> 


也 可 以 使 用 结果 为 整数 的 表达 式 : 


<multiInstanceLoopCharacteristics isSequential="false|true"> 
<loopCardinality>${nrofOoOrders-nrofCcancellations}</loopCardinality> 
</multiInstanceLoopCharacteristics> 


另 一 个 定义 实例 数目 的 方法 是 ， 通 过 loopDatalnputRef 子 元 素 ， 设 置 一 个 类 型 为 集合 的 流程 变量 名 。 对 于 集合 中 的 每 个 
素 ， 都 会 创建 一 个 实例 。 也 可 以 通过 inputDataltem 子 元 素 指定 集合 。 下 面 的 代码 演示 了 这 些 配置 : 


<userTask id="miTasks" name="My Task ${loopCounter}" activiti:assignee="${assignee}"> 
<multiInstanceLoopCharacteristics isSequential="false"> 
<loopDataInputRef>assigneeList</loopDataInputRef> 
<inputDataItem name="assignee" /> 
</multiInstanceLoopCharacteristics> 
</userTask> 


假设 assigneeList 变量 包含 gonzo, foziee]。 在 上 面 代 码 中 ， 三 个 用 户 任务 会 同时 创建 。 每 个 分 支 都 会 拥有 一 
个 用 名 为 assignee 的 流程 变量 ， 这 个 变量 会 包含 集合 中 的 对 应 元 素 ， 在 例子 中 会 用 来 设置 用 户 任务 的 分 配 者 。 


loopDatalnputRef 和 inputDataltem 的 缺点 是 1) 名 字 不 好 记 ， 2) 根据 BPMN 2.0 格式 定义 ， 它 们 不 能 包含 表达 式 。activiti 
通过 在 multilnstanceCharacteristics 中 设置 collection 和 elementVariable 属性 解决 了 这 个 问题 : 


<userTask id="miTasks" name="My Task" activiti:assignee="${assignee}"> 
<multiInstanceLoopCharacteristics isSequential="true" 
activiti:collection="${myService.resolveUsersForTask()}" activiti:elementVariable="assignee" > 
</multiInstanceLoopCharacteristics> 
</userTask> 


多 实例 节点 在 所 有 实例 都 完成 时 才 会 结束 。 ne 如 果 表 达 式 返回 true， 所 有 其 他 
的 实例 都 会 销毁 ， 多 实例 节点 也 会 结束 ， 流 程 会 继续 执行 。 这 个 表达 式 必 须 定 义 在 completionCondition 子 元 素 中 。 


<userTask id="miTasks" name="My Task" activiti:assignee="${assignee}"> 
<multiInstanceLoopCharacteristics isSequential="false" 
activiti:collection="assigneeList" activiti:elementVariable="assignee" > 
<completionCondition>${nrofCcompletedInstances/nrofInstances >= 0.6 }</completionCondition> 
</multiInstanceLoopCharacteristics> 
</userTask> 


在 这 里 例子 中 ， 会 为 assigneeList 集合 的 每 个 元 素 创 建 一 个 并 行 的 实例 。 当 60% 的 任务 完成 时 ， 其 他 任务 就 会 删除 ， 流 程 继 
续 执 行 。 
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Boundary events and multi-instance 边界 事件 和 多 实例 


因为 多 实例 是 一 个 普通 节点 ， 它 也 可 以 在 边缘 使 用 边界 事件 。 对 于 中 断 型 边界 事件 ， 当 捕获 事件 时 ， 所 有 激活 的 实例 都 会 销 
毁 。 参考 以 下 多 实例 子 流程 


多 


Execute script 





这 里 ， 子 流程 的 所 有 实例 都 会 在 定时 器 触发 时 销毁 ， 无 论 有 多 少 实 例 ， 也 不 管内 部 哪个 节点 没有 完成 。 
Compensation Handlers 补偿 处 理 器 


Description 描述 
[试验 ] 


如 果 一 个 节点 用 来 补偿 另 一 个 节点 的 业务 ， 它 可 以 声明 为 一 个 补偿 处 理 器 。 补偿 处 理 器 不 包含 普通 的 流 ， 只 在 补偿 事件 触发 
时 执行 。 


补偿 处 理 器 不 能 包含 进入 和 外 出 顺序 流 。 
补偿 处 理 器 必须 使 用 直接 关联 分 配给 一 个 补偿 边界 事件 。 
Graphical notation 图 形 标记 


如 果 节 点 是 补偿 处 理 器 ， 补 偿 事 件 图 标 会 显示 在 中 间 底 部 区 域 。 下 面 的 流程 图 显示 了 一 个 服务 任务 ， 附 加 了 一 个 补偿 边界 事 
件 ， 并 分 配 了 一 个 补偿 处 理 器 。 注意 "cancel hotel reservation" 服务 任务 中 间 底 部 区 域 显示 的 补偿 处 理 器 图 标 。 


Tasks 任务 148 














Activiti 5.x User Guide 《Activiti 5.x 用 户 指南 》 中 文 翻译 





book hotel 





cancel hotel 
reservation 


« 







XML representation 内 容 


为 了 声明 作为 补偿 处 理 器 的 节点 ， 我 们 需要 把 isForCompensation 设置 为 true : 


<serviceTask id="undoBookHotel" isForCompensation="true" activiti:class="..."> 
</serviceTask> 
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Sub-Processes and Call Activities 子 流程 和 调用 节点 


Sub-Process 


Description 描述 


子 流 程 (Sub-process) 是 一 个 包含 其 他 节点 ， 网 关 ， 事 件 等 等 的 节点 。 它 自己 就 是 一 个 流程 ， 同 时 是 更 大 流程 的 一 部 分 。 
子 流程 是 完全 定义 在 父 流 程 里 的 〈 这 就 是 为 什么 叫做 内 藤子 流程 ) 。 


子 流 程 有 两 种 主要 场景 : 


子 流程 可 以 使 用 继承 式 建 模 。 很 多 建 模 工 具 的 子 流程 可 以 折 释 ， 把 子 流程 的 内 部 细节 隐藏 ， 显 示 一 个 高 级 别 的 端 对 端的 
2 总 览 。 
e 子 流程 会 创建 一 个 新 的 事件 作用 域 。 子 流 程 运行 过 程 中 抛 出 的 事件 ， 可 以 被 子 流程 边缘 定义 的 边界 事件 捕获 ， 这 样 就 
Ll we ed 


使 用 子 流程 要 考虑 如 下 限制 : 
e 子 流程 只 能 包含 一 个 空 开 始 事 件 ， 不 能 使 用 其 他 类 型 的 开始 事件 。 子 路 程 必须 至 少 有 一 个 结束 节点 。 注 意 ，BPMN 2.0 


规范 允许 忽略 子 流程 的 9 点 ， 但 是 当前 activiti 的 实现 并 不 支持 。 
e 顺序 流 不 能 跨越 子 流程 的 边 


Graphical notation 图 形 标记 


子 流 程 显 示 为 标准 的 节点 ， 国 角 矩 形 。 这 时 子 流程 是 折 台 的 ， 只 显示 名 称 和 一 个 加 号 标记 ， 展 示 了 高 级 别 的 流程 总 览 : 









Order handling 
and shipping 






Order billing 


这 时 子 流程 是 展开 的 ， 子 流程 的 步骤 都 显示 在 子 流程 边界 内 


Take order 


心 心 


Enter customer Create /verify 


J details contract 





使 用 子 流程 的 主要 原因 ， 是 定义 对 应 事件 的 作用 域 。 下 面 流 程 模 型 演示 了 这 个 功能 : 调查 软件 /调查 引荐 任务 需要 同步 执行 ， 
两 个 任务 需要 在 同时 完成 ， 在 二 线 支持 解决 之 前 。 这 里 ， 定 时 器 的 作用 域 (比如 ， 节 点 需要 及 时 完成 ) 是 由 子 流程 限制 的 。 
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心 


Investigate 
hardware 








各 


Write report 





Investigate 
software 





Hand over System 
failure to Level 2 
support 






XML representation 内 容 


子 流 程 定义 为 subprocess 元 素 。 所 有 节点 ， 网 关 ， 事 件 ， 等 等 。 它 是 子 流程 的 一 部 分 ， 需 要 放 在 这 个 元 素 里 。 


<SubProcess id="subProcess"> 
<startEvent id="subProcessStart" /> 
. Other Sub-Process elements ... 
<endEvent id="subProcessEnd" /> 


</subProcess> 


Event Sub-Process 事件 子 流程 


Description 描述 


事件 子 流程 是 BPMN 2.0 中 的 新 元 素 。 事 件 子 流程 是 由 事件 触发 的 子 流程 。 事件 子 流程 可 以 添加 到 流程 级 别 或 任意 子 流程 级 
别 。 用 于 触发 事件 子 流程 的 事件 是 使 用 开始 事件 配置 的 。 为 此 ， 事 件 子 流程 是 不 支持 空 开 始 事件 的 。 事件 子 流程 可 以 被 消息 
事件 ， 错 误 事件 ， 信 号 事件 ， 定 时 器 事件 ， 或 补偿 事件 触发 。 开 始 事件 的 订阅 在 包含 事件 子 流程 的 作用 域 (流程 实例 或 子 流 
程 ) 创建 时 就 会 创建 。 当 作用 域 销毁 也 会 删除 订阅 。 


事件 子 流程 可 以 是 中 断 的 或 非 中 断 的 。 一 个 中 断 的 子 流程 会 取消 当前 作用 域内 的 所 有 流程 。 非 中 断 事件 子 流程 会 创建 那 一 个 
新 的 同步 分 支 。 中 断 事 件 子 流程 只 会 被 每 个 激活 状态 的 宿主 触发 一 次 ， 非 中 断 事件 子 流程 可 以 触发 多 次 。 子 流程 是 否 是 终端 
的 ， 配 置 使 用 事件 子 流程 的 开始 事件 配置 。 


事件 子 流程 不 能 有 任何 进入 和 外 出 流程 。 当 事件 触发 一 个 事件 子 流程 时 ， 输 入 顺序 流 是 没有 意义 的 。 当 事 件 子 流 程 结束 时 ， 
无 论 当前 作用 域 已 经 结束 了 (中断 事 件 子 流程 的 情况 ) ， 或 为 非 中 断 子 流程 生成 同步 分 支 会 结束 。 


当前 的 限制 : 


e activiti 只 支持 中 断 事件 子 流程 。 
e activiti 只 支持 使 用 错误 开始 事件 或 消息 开始 事件 的 事件 子 流 程 。 
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Graphical notation 图 形 标记 


事件 子 流程 可 以 显示 为 边框 为 虚线 的 内 嵌 子 流程 。 


"regular" embedded subprocess : event subprocess 





XML representation 内 容 


事件 子 流程 的 XML 内 容 与 内 敌 子 流程 是 一 样 的 。 另外 ， 要 把 triggeredByEvent 属性 设置 为 true : 


<SubProcess id="eventSubProcess" triggeredByEvent="true"> 


</SubProcess> 


Example 实例 


下 面 是 一 个 使 用 错误 开始 事件 触发 的 事件 子 流程 的 实例 。 事 件 子 流程 是 放 在 “流程 级 别 " 的 ， 意 思 是 ， 作 用 于 流程 实例 : 










息 Enough data? 


Review Job 
Application 


new job application 
application reviewed 
received 


not enough 
data 






Provide 
additional 
data 






not enough 
data 


事件 子 流程 的 XML 如 下 所 示 : 


<SubProcess id="eventSubProcess" triggeredByEvent="true"> 
<startEvent id="catchError"> 
<errorEventDefinition errorRef="error" /> 
</startEvent> 
<sequenceFlow id="flow2" sourceRef="catchError" targetRef="taskAfterErrorCatch" /> 
<userTask id="taskAfterErrorCatch" name="Provide additional data" /> 
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</SubProcess> 


如 上 面 所 述 ， 事 件 子 流程 也 可 以 添加 成 内 柑 子 流程 。 如 果 添 加 为 内 柑 子 流程 ， 它 


其 


一 


实 是 边界 事件 的 一 种 替代 方案 。 
两 个 流程 图 。 两 种 情况 内 谋 子 流程 会 抛 出 一 个 错误 事件 。 两 种 情况 错误 都 会 被 捕获 并 使 用 一 个 用 户 任务 处 理 。 


考虑 下 面 


. 
. 
» 
. 
. 
. 
' 
. 
" 





the error is completely 
handled by the subprocess; 


the subprocess is left using a 
single sequenceflow 


相对 于 : 


, 
the error handler has access 
to variables local to the 
subprocess 






日 


"|the error is handled by the 
和 Bae process; 


ne subprocess is left using 
different sequenceflows 


” 
DD 
. 


the variables of the | 
subprocess are not available 
anymore 
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两 种 场景 都 会 执行 相同 的 任务 。 然 而 ， 两 种 建 模 的 方式 是 不 同 的 : 


。 内 嵌 子 流程 是 使 用 与 执行 作用 域 宿主 相同 的 流程 执行 的 。 意 思 是 内 嵌 子 流程 可 以 访问 它 作 用 域内 的 内 部 变量 。 当 使 用 边 
界 事件 时 ， 执 行内 许 子 流程 的 流程 会 删除 ， 并 生成 一 个 流程 根据 边界 事件 的 顺序 流 继续 执行 。 这 意味 着 内 赃 子 流程 创建 
的 变量 不 再 起 作用 了 。 

e 当 使 用 事件 子 流程 时 ， 事 件 是 完全 由 它 添加 的 子 流程 处 理 的 。 当 使 用 边界 事件 时 ， 事 件 由 父 流程 处 理 。 


这 两 个 不 同 点 可 以 帮助 我 们 决定 是 使 用 边界 事件 还 是 内 同事 件 子 流程 来 解决 特定 的 流程 建 模 /实现 问题。 
Transaction subprocess 事务 子 流 程 

[试验 ] 

Description 描述 


事务 子 流程 是 内 蓄 子 流程 ， 可 以 用 来 把 多 个 流程 放 到 一 个 事务 里 。 事务 是 一 个 逻辑 单元 ， 可 以 把 一 些 单独 的 节点 放 在 一 起 ， 
这 样 它们 就 可 以 一 起 成 功 或 一 起 失败 。 事 务 可 能 的 结果 : 事务 可 以 有 三 种 可 能 的 结果 : 


e 事务 成 功 ， 如 果 没 有 取消 也 没有 因为 问题 终结 。 如 果 事 务 子 流程 是 成 功 的 ， 就 会 使 用 外 出 顺序 流 继续 执行 。 如 果 流 程 后 
来 抛 出 了 一 个 补偿 事件 ， 成 功 的 事务 可 能 被 补偿 。 注意 : 和 普通 内 钳子 流程 一 样 ， 事 务 可 能 在 成 功 后 ， 使 用 中 间 补 偿 事 
件 进 行 补偿 。 

。 事务 取消 ， 如 果 流 程 到 达 取 消 结 束 事件 。 这 时 ， 所 有 流程 都 会 终结 和 删除 。 触 发 补偿 的 一 个 单独 的 流程 ， 会 通过 取消 边 
界 事件 继续 执行 。 在 补偿 完成 之 后 ， 事 务 子 流程 会 使 用 取消 边界 事务 的 外 出 顺序 流向 下 执行 。 

e 事务 被 问题 结束 ， 如 果 跑 出 了 一 个 错误 事件 ， 而 且 没 有 在 事务 子 流程 中 捕获 。 (如 果 错 误 被 事务 子 流程 的 边界 事件 处 理 
了 ， 也 会 这 样 应 用 。) 这 时 ， 不 会 执行 补偿 。 


下 面 的 图 形 演示 了 三 种 不 同 的 结果 : 


transaction subprocess 


charge credit 
book hotel 下 


C9 cannot 坑 


charge card Sen 


cancel hotel 
reservation 


booking 
system 
allure 





hazard cancelled 


与 A CID 事务 的 关系 : 一 定 不 要 把 bpmn 事务 子 流 程 与 技术 (ACID) 事务 相 混 淆 。 bpmn 事 务 子 流程 不 是 技术 事务 领域 的 东 
西 。 要 理解 activiti 中 的 事务 管理 ， 请 参考 并 发 与 事务 。 bpmn 事务 和 技术 事务 有 以 下 不 同 点 : 





e ACID 事务 一 般 是 短期 的 ，bpmn 事 务 可 能 持续 几 小 时 ， 几 天 ， 甚 至 几 个 月 才能 完成 。 (考虑 事务 中 包含 的 节点 可 能 有 用 
户 任务 ， 一 般 人 员 响 应 的 时 间 比 应 用 时 间 要 长 。 或 者 ， 在 其 他 情况 下 ，bpmn 事务 可 能 要 等 待 发 生 一 些 事务 事件 ， 就 像 
要 根据 某 种 次 序 执行 。) 这 种 操作 通常 要 相 比 更 新 数据 库 的 一 条 数据 ， 或 把 一 条 信息 保存 到 事务 性 队列 中 ， 消 耗 更 长 的 
时 间 来 完成 。 

e 因为 不 能 在 整个 业务 节点 的 过 程 中 保持 一 个 技术 性 的 事务 ， 所 以 bpmn 事务 一 般 要 跨越 多 个 ACID 事务 。 
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e。 因为 bpmn 事务 会 跨越 多 个 ACID 事务 ， 所 以 会 吕 失 ACID 的 特性 。 比 如 ， 考 虑 上 述 例子 。 假设 “约定 旅店 "和 “ 刷 信用 
卡 "操作 在 单独 的 ACID 事务 中 执行 。 也 假设 “预定 旅店 "节点 已 经 成 功 了 。 现 在 我 们 你 于 一 个 中 间 不 稳定 状态 ， 因 为 我 们 
预定 了 酒店 ， 但 是 还 没有 刷 信 用 卡 。 现在 ， 在 一 个 ACID 事 务 中 ， 我 们 要 依次 执行 不 同 的 操作 ， 也 会 有 一 个 中 间 不 稳定 
状态 。 不 同 的 是 ， 这 个 中 间 状 态 对 事务 的 外 部 是 可 见 的 。 比如 ， 如 果 通 过 外 部 预定 服务 进行 了 预定 ， 其 他 使 用 相同 预定 
服务 的 部 分 就 可 以 看 到 旅店 被 预定 了 。 这 意味 着 实现 业务 事务 时 ， 我 们 完全 失去 了 隔离 属性 ( 注 : 我 们 也 经 常 放弃 隔离 
性 ， 来 为 ACID 事 务 获得 更 高 的 并 发 ， 但 是 我 们 可 以 完全 控制 ， 中 间 不 稳定 状态 也 只 持续 很 短 的 时 间 ) 。 





e bpmn 业务 事务 也 不 能 使 用 通常 的 方式 回 滚 。 因 为 它 跨 越 了 多 个 事务 ，bpmn 事务 取消 时 一 些 ACID 事务 可 能 已 经 提交 
了 。 这 时 ， 它 们 不 能 被 回 滚 了 。 


因为 bpmn 事务 实际 上 运行 时 间 很 长 ， 缺 乏 隔离 性 和 回 滚 机 制 都 需要 被 区 别 对 待 。 实际 上 ， 这 里 也 没有 更 好 的 办 法 在 特定 领 
域 义理 这 些 问题 : 


e。 使 用 补偿 执行 回 滚 。 如 果 事 务 范围 抛 出 了 取消 事件 ， 会 影响 已 经 执行 成 功 的 节点 ， 并 使 用 补偿 处 理 器 执行 补偿 。 

e 隔离 性 的 缺乏 通常 使 用 特定 领域 的 解决 方法 来 解决 。 比 如 ， 上 面 的 例子 中 ， 一 个 旅店 房间 可 能 会 展示 给 第 二 个 客户 ， 在 
我 们 确认 第 一 个 客户 付费 之 前 。 虽然 这 可 能 与 业务 预期 不 符 ， 预 定 服务 可 能 选择 允许 一 些 过 度 的 预约 。 

e 另外 ， 因 为 事务 会 因为 风险 而 中 断 ， 预 定 服务 必须 处 理 这 种 情况 ， 已 经 预定 了 旅店 ， 但 是 一 直 没 有 付款 的 情况 。 (因为 
事务 被 中 断 了 ) 。 这 时 预定 服务 需要 选择 一 个 策略 ， 在 旅店 房间 预定 超过 最 大 人 允许 时 间 后 ， 如 果 还 没有 付款 ， 预 定 就 会 
取消 。 


综 上 所 述 : ACID 义理 的 是 通常 问题 ( 回 滚 ， 隔 离 级 别 和 局 发 式 结果 ) ， 在 实现 业务 事务 时 ， 我 们 需要 找到 特定 领域 的 解决 
方案 来 处 理 这 些 问 题 。 


目前 的 限制 : 


e bpmn 规 范 要 求 流程 引擎 能 根据 底层 事务 的 协议 处 理事 件 ， 比 如 如 果 诡 层 协 议 触 发 了 取消 事件 ， 事 务 就 会 取消 。 作为 内 
柑 引 擎 ，activiti 目 前 不 支持 这 项 功能 。 (对 此 造成 的 后 果 ， 可 以 人 参考 下 面 的 一 致 性 讨论 ) 。 


ACID 事 务 项 层 的 一 致 性 和 优化 并 发 : bpmn 事务 保证 一 致 性 ， 要 么 所 有 节点 都 成 功 ， 或 者 一 些 节点 成 功 ， 对 其 他 成 功 的 节点 
进行 补偿 。 无 论 哪 种 方式 ， 都 会 有 一 致 性 的 结果 。 不 过 要 讨论 一 些 activiti 内 部 的 情况 ，bpmn 事务 的 一 致 性 模型 是 辣 加 在 流 
程 的 一 致 性 模型 之 上 的 。activiti 执行 流程 是 事务 性 的 。 并 发 使 用 了 乐观 锁 。 在 activiti 中 ，bpmn 错误 ， 取 消 和 补偿 事件 都 建 
立 在 同样 的 acid 事务 与 乐观 锁 之 上 。 比如， 取消 结束 事件 只 能 触发 它 实 际 到 达 的 补偿 。 如 果 之 前 服务 任务 抛 出 了 未 声明 的 
异常 。 或 者 ， 补偿 处 理 器 的 效果 无 法 提交 ， 如 果 底 层 的 acid 事务 的 参与 者 把 事务 设置 成 必须 回 滚 。 或 者 当 两 个 并 发 流程 到 
达 了 取消 结束 事件 ， 可 能 会 触发 两 次 补偿 ， 并 因为 乐观 锁 异 常 失败 。 所 有 这 些 都 说 明 activiti 中 实现 bpmn 事务 时 ， 相 同 的 
规则 也 作用 域 普通 的 流程 和 子 流 程 。 所 以 为 了 保证 一 致 性 ， 重 要 的 是 使 用 一 种 方式 考虑 实现 乐观 事务 性 的 执行 模型 。 


Graphical notation 图 形 标记 


事务 子 流程 显示 为 内 许 子 流程 ， 使 用 双 线 边框 。 


transaction subprocess 





XML representation 内 容 


事务 子 流程 使 用 transaction 标签 : 
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<transaction id="myTransaction" > 


</transaction> 


Example 实例 


下 面 是 事务 子 流程 的 实例 : 





PP 
make reservations 


book hotel 


A sucessful? 
charge credit 
card 


book flight 


failure 


Y 
' cancel flight 
reservation 


« 











cancelled 


Call activity (subprocess) 调用 活动 〈 子 流程 ) 
Description 描述 


BPMN 2.0 区 分 了 普通 子 流程 ， 也 叫做 内 徐 子 流程 ， 和 调用 节点 ， 看 起 来 很 相似 。 从 概念 上 讲 ， 当 流程 抵达 时 ， 两 者 都 会 调 
用 子 流 程 。 


不 同 点 是 调用 节点 引用 流程 定义 外 部 的 一 个 流程 ， 子 流程 会 内 嵌 到 原始 的 流程 定义 中 。 使 用 调用 节点 的 主要 场景 是 需要 重用 
流程 定义 ， 这 个 流程 定义 需要 被 很 多 其 他 流程 定义 调用 的 时 候 。 


当 流 程 执行 到 调用 节点 ， 会 创建 一 个 新 分 支 ， 它 是 到 达 调 用 节点 的 流程 的 分 支 。 这 个 分 支 会 用 来 执行 子 流程 ， 默 认 创 建 并 行 
子 流程 ， 就 像 一 个 普通 的 流程 。 上 级 流程 会 等 待 子 流程 完成 ， 然 后 才 会 继续 向 下 执行 


Graphical notation 图 形 标记 


调用 节点 显示 与 子 流程 相同 ， 不 过 是 粗 边框 (无 论 是 折 双 和 展开 的 ) 。 根据 不 同 的 建 模 工 具 ， 调 用 节点 也 可 以 展开 ， 但 是 显 
示 为 折 受 的 子 流程 。 









Order handling 
and shipping 






Order billing 


XML representation 内 容 
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有 种 调用 节点 是 经 常 性 的 节点 ， 需 要 calledElement 引用 被 key 定义 的 流程 。 在 实践 中 ， 这 意味 着 流程 的 ID 用 于 
calledElement。 


<callActivity id="callCheckCreditProcess" name="Check credit" calledElement="checkCreditProcess" /> 


注意 ， 子 流程 的 流程 定义 是 在 执行 阶段 解析 的 。 就 是 说 子 流程 可 以 与 调用 的 流程 分 开 部 署 ， 如 果 需 要 的 话 。 


Passing variables 传递 变量 


可 以 把 流程 变量 传递 给 子 流程 ， 反 之 亦 然 。 数 据 会 复制 给 子 流 程 ， 当 它 和 启动 的 时 候 ， 并 在 它 结束 的 时 候 复制 回 主流 程 。 


<callActivity id="callSubProcess" calledElement="checkCreditProcess" > 
<extensionElements> 
<activiti:in source="someVariableInMainprocess" target="nameOfVariableInSubpProcess" /> 
<activiti:out source="someVariableInSsubpProcss" target="nameOfVariableInMainpProcess" /> 
</extensionElements> 
</callActivity> 


我 们 使 用 Activiti 扩展 来 简化 BPMN 标准 元 素 调用 datalnputAssociation 和 dataOutputAssociation， 这 只 在 你 使 用 BPMN 
2.0 标准 方式 声明 流程 变量 才 管 用 。 


这 里 也 可 以 使 用 表达 式 : 


<callActivity id="callSubProcess" calledElement="checkCreditProcess" > 
<extensionElements> 
<activiti:in sourceExpression="${x+5}"" target="y" /> 
<activiti:out source="${y+5}" target="z" /> 
</extensionElements> 
</callActivity> 


最 后 z=y+5=x+5+5 


Example 实例 


下 面 的 流程 图 演示 了 简单 订单 处 理 。 先 判断 客户 端 信 用 ， 这 可 能 与 很 多 其 他 流程 相同 。 检查 信用 阶段 这 里 设计 成 调用 节点 。 






GS 


Receive order 









各 


Prepare and 
ship 






check credit 


流程 看 起 来 像 这 样 的 : 


<startEvent id="thestart" /> 
<sequenceFlow id="flowi1" sourceRef="thestart" targetRef="receiveOrder" /> 


<manualTask id="receiveOrder" name="Receive Order" /> 
<sequenceFlow id="flow2" sourceRef="receiveOrder" targetRef="callCheckCreditProcess" /> 


<callActivity id="callCheckCreditProcess" name="Check credit" calledElement="checkCreditProcess" /> 
<sequenceFlow id="flow3" sourceRef="callCheckCreditProcess" targetRef="prepareAndshipTask" /> 


<userTask id="prepareAndshipTask" name="Prepare and Ship" /> 
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<sequenceFlow id="flow4" SourceRef="prepareAndShipTask" targetRef="end" /> 


<endEvent id="end" /> 


子 流程 看 起 来 像 这 样 的 : 






Contact customer 
for further 
information 


dissapprove 








各 


Verify credit 
history 


approve 
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Transactions and Concurrency 事务 与 并 发 


Asynchronous Continuations 异步 操作 


Activiti 通过 事务 方式 执行 流程 ， 可 以 根据 你 的 需求 定制 。 现 在 开始 看 一 下 Activiti 通常 是 如 何 处 理事 务 的 。 如 果 触 发 了 

Activiti 的 操作 〈 比 如 ， 开 始 流程 ， 完 成 任务 ， 触 发 流程 继续 执行 ) ， Activiti 会 推进 流程 ， 直 到 每 个 分 支 都 进入 等 待 状态 。 
膝 度 优先 搜索 ， 如 果 每 个 分 支 都 遇 到 等 待 状态 ， 就 会 返回 。 等 待 状态 是 " 稍 后 "需要 执行 任务 ， 
触发 可 能 来 自 外 部 ， 比 如 用 户 任务 或 接收 到 一 个 消 


更 抽象 的 说 ， 它 会 流程 图 执行 ; 
就 是 说 Activiti 会 把 当前 状态 保存 到 数据 库 中 ， 然 后 等 待 下 一 次 触发 。 


息 ， 也 可 能 来 自 Activiti 本 身 ， 上 比如 我 们 设置 了 定时 器 事件 。 下 面 图 片 展示 了 这 种 操作 : 


Application / Client Thread 3 


taskService.complete (id) Cr 
s - 


%» a . 和 
.| 所 ] nnn > 中 


全 















validate 


provide 
address 


shipping 
address I 










it until 
nex 晶 business 
day 


1st TX : 2nd TX 


Logical unit of work which 
has to succeed or fail atomically 
-> executed in a single transaction 


我 们 可 以 看 到 包含 用 户 任务 ， 服 务 任务 和 定时 器 事件 的 流程 。 完 成 用 户 任务 ， 和 校 验 地 址 是 在 同一 个 工作 单元 中 ， 所 以 它们 
的 成 功 和 失败 是 原子 性 的 。 意 味 着 如 果 服 务 任务 抛 出 异常 ， 我 们 要 回 滚 当 前 事务 ， 这 样 流程 会 退回 到 用 户 任务 ， 用 户 任务 就 
依然 在 数据 库 里 。 这 就 是 Activiti 默认 的 行为 。 在 (1) 中 应 用 或 客户 端 线程 完成 任务 。 这 会 执行 服务 ， 流 程 推进 ， 直 到 遇 到 
一 个 等 待 状态 ， 这 里 就 是 定时 器 (2) 。 然 后 它 会 返回 给 调用 者 (3) ， 并 提交 事务 (如 果 事 务 是 由 activiti 开 启 的 ) 。 















有 的 时 候 ， 这 不 是 我 们 想 要 的 。 有 时 我 们 需要 自己 控制 流程 中 事务 的 边界 ， 这 样 就 能 把 业务 远 辑 包 应 在 一 起 。 这 就 需要 使 用 
异步 执行 了 。 参 考 下 面 的 流程 〈 判 断 ) 
Application / client Thread 。 Activiti job Executor 
四 Thread 
taskService.complete (id) ee | KR 
2 : 多 3 
| man > | 
i generate send invoice 
ls Involce to customer 
| wai until 
next siness 
I | activiti:async=“true” y 
5 
iX 2" TX 3" TX 
Generating the invoice is not part of the same 
logical unit of work 
-> executed asynchronously in a 2" transaction 
159 
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这 次 我 们 完成 了 用 户 任 务 ， 生 成 一 个 发 票 ， 把 发 票 发 送 给 客户 。 这 次 生成 发 票 不 在 同一 个 工作 单元 内 了 ， 所 以 我 们 不 想 对 用 
户 任务 进行 回 滚 ， 如 果 生 成 发 票 出 错 了 。 所 以 ， 我 们 想 让 Activiti 实现 的 是 完成 用 户 任务 (1) ， 提 交 事 务 ， 返 回 给 调用 者 应 
用 。 然 后 在 后 台 的 线程 中 ， 异 步 执行 生成 发 票 。 后 台 线 程 就 是 Activiti 的 job 执行 器 (其 实 是 一 个 线程 池 ) 周期 对 数据 库 的 
job 进行 扫描 。 所 以 后 面 的 场景 ， 当 我 们 到 达 "generate invoice" 任 务 ， 我 们 为 activiti 创建 一 个 稍 后 执行 的 job "消息 "， 并 把 
它 保 存 到 数据 库 。job 会 被 job 执行 器 获取 并 执行 。 我 们 也 会 给 本 地 job 执行 器 一 个 提醒 ， 告 诉 它 有 一 个 新 job， 来 增加 性 


能 。 


要 想 使 用 这 个 特性 ， 我 们 要 使 用 activiti:async="true" 扩展 。 例 子 中 ， 服 务 任务 看 起 来 就 是 这 样 
<serviceTask id="service1" name="Generate Invoice" activiti:class="my.custom.Delegate" activiti:async="true" /> 


activiti:async 可 以 使 用 到 如 下 bpmn 任务 类 型 中 : task, serviceTask, scriptTask, businessRuleTask, sendTask, receiveTask, 
userTask, subProcess, callActivity 


对 于 userTask，receiveTask 和 其 他 等 待 装填 ， 异 步 执 行 的 作用 是 让 开始 流程 监听 器 运行 在 一 个 单独 的 线程 /事务 中 。 
Fail Retry 失败 重 试 


Activiti 在 其 默认 配置 ， 重 试 3 次 工作 ， 当 在 一 个 作业 执行 遇 到 任何 异常 情况 。 这 对 异步 任务 工作 来 说 也 成 立 。 在 某 些 情况 
下 ， 就 需要 更 多 的 灵活 性 。 有 两 个 参数 进行 配置 


e 重 试 次 数 
e@ 重 试 延迟 时 间 


这 些 参数 可 以 通过 配置 activiti:failedJobRetryTimeCycle。 这 里 是 一 个 简单 的 使 用 示例 : 


<serviceTask id="failingServiceTask" activiti:async="true" activiti:class="org.activiti.engine.test.jobexecutor .RetryFs 
<extensionElements> 


<activiti:failedJobRetryTimeCycle>R5/PT7M</activiti:failedJobRetryTimeCycle> 
</extensionElements> 


</serviceTask> 


工人 Eee 





Exclusive Jobs 排他 任务 


从 Activiti 5.9 开 始 ，JobExecutor 能 保证 同一 个 流程 实例 中 的 job 不 会 并 发 执行 。 为 啥 呢 ? 


Why exclusive Jobs? 为 什么 要 使 用 排他 任务 ? 


参考 如 下 流程 定义 


Transactions and Concurrency 事务 与 并 发 
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Async continuation: 
.jactiviti:async= true” 


ps “* 









book hotel 


book flight 





book concert 
tickets 


我 们 有 一 个 并 行 网 关 ， 后 面 有 三 个 服务 任务 ， 它 们 都 设置 为 异步 执行 。 这 样 会 添加 三 个 job 到 数据 库 里 。 一 旦 job 进入 数据 
库 ， 它 就 可 以 被 jobExecutor 执行 了 。JobExecutor 会 获取 job， 把 它们 代理 到 工作 线程 的 线程 池 中 ， 会 在 那里 真正 执行 
job。 就 是 说 ， 使 用 异步 执行 ， 你 可 以 把 任务 分 配给 这 个 线程 池 (在 集群 环境 ， 可 能 会 使 用 多 个 线程 池 ) 。 这 通常 是 个 好 事 
情 。 然而 它 也 会 产生 问题 : 一 致 性 。 考 虑 一 下 服务 任务 后 的 汇聚 。 当 服 务 任 务 完 成 后 ， 我 们 到 达 并 发 汇聚 节点 ， 需 要 决定 是 
等 待 其 他 分 支 ， 还 是 继续 向 下 执行 。 就 是 说 ， 对 每 个 到 达 并 行 汇聚 的 分 支 ， 我 们 都 需要 判断 是 继续 还 是 等 待 其 他 分 支 的 一 个 
或 多 个 分 支 。 


为 什么 这 就 是 问题 了 呢 ? 因为 服务 任务 配置 成 使 用 异步 执行 ， 可 能 相关 的 job 都 在 同一 时 间 被 获取 ， 被 JobExecutor 分 配给 
不 同 的 工作 线程 执行 。 结果 是 三 个 单独 的 服务 执行 使 用 的 事务 在 到 达 并 发 汇聚 时 可 能 重重 。 如 果 出 现 了 这 个 问题 ， 这 些 事务 
是 互相 不 可 见 的 ， 其 他 事务 同时 到 达 了 相同 的 并 发 汇聚 ， 假 设 它们 都 在 等 待 其 他 分 支 。 然 而 ， 每 个 事务 都 假设 它们 在 等 待 其 
他 分 支 ， 所 以 没有 分 支 会 越过 并 发 汇聚 继续 执行 ， 流 程 实例 会 一 直 在 等 待 状态 ， 无 法 继续 执行 。 


Activiti 是 如 何 解决 这 个 问题 的 ? Activiti 使 用 了 乐观 锁 。 当 我 们 基于 判断 的 数据 看 起 来 不 是 最 新 的 时 (因为 其 他 事务 可 能 在 

我 们 提交 之 前 进行 了 修改 ， 我 们 会 在 每 个 事务 里 增加 数据 库 同一 行 的 版 本 ) 。 这 时 ， 第 一 个 提交 的 事务 会 成 功 ， 其 他 会 因为 

乐观 锁 异 常 导 致 失败 。 这 就 解决 了 我 们 上 面 讨论 的 流程 的 问题 : 如 果 多 个 分 支 同 步 到 达 并 行 汇 聚 ， 它们 会 假设 它们 都 在 登 

录 ， 并 增加 它们 父 流程 的 版 本 号 (流程 实例 ) 然后 尝试 提交 。 第 一 个 分 支 会 成 功 提交 ， 其 他 分 支 会 因为 乐观 锁 导 致 失败 。 因 

为 流程 是 被 job 触发 的 ， Activiti 会 尝试 在 等 待 一 段 时 间 后 尝试 执行 同一 个 job， 想 这 段 时 间 可 以 同步 网 关 的 状态 。 

这 是 一 个 很 好 的 解决 方案 吗 ? 像 我 们 看 到 的 一 样 ， 乐 观 锁 人 允许 Activiti 避免 非 一 致 性 。 它 确定 我 们 不 会 “ 堵 在 汇聚 网 关 "， 意思 

是 : 或 者 所 有 分 支 都 通过 网 关 ， 或 者 数据 库 中 的 job 正在 尝试 通过 。 然 而 ， 虽 然 这 是 一 个 对 于 持久 性 和 一 致 性 的 完美 解决 方 

案 ， 但 对 于 上 层 来 说 不 一 定 是 期 望 的 行为 : 

e Activiti 只 会 对 同一 个 job 重 试 估计 次 数 (默认 配置 为 3) 。 之 后 ，job 还 会 在 数据 库 里 ， 但 是 不 会 再 重 试 了 。 意味 着 这 个 
操作 必须 手工 执行 job 的 触发 。 


e 如 果 job 有 非 事务 方面 的 效果 ， 它 不 会 因为 失败 的 事务 回 滚 。 上 比如， 如果" 预定 演唱 会 门票 "服务 没有 与 Activiti 共享 事 
务 ， 重 试 job 可 能 导致 我 们 预定 了 过 多 门票 。 


在 Activiti 5.9 中 ， 我 们 推荐 了 新 的 概念 ， 并 已 经 在 jBPM 4 中 实现 了 ， 叫 做 "排他 job"。 
What are exclusive jobs? 什么 是 排他 job ? 


对 于 一 个 流程 实例 ， 排 他 任务 不 能 同时 执行 两 个 。 考 虑 上 面 的 流程 : 如 果 我 们 把 服务 任务 申请 为 排他 任务 ，JobExecutor 会 
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保证 对 应 的 job 不 会 并 发 执行 。 相反 ， 它 会 保证 无 论 什 么 时 候 获 取 一 个 流程 实例 的 排他 任务 ， 都 会 把 同一 个 流程 实例 的 其 他 
任务 都 取出 来 ， 放 在 同一 个 工作 线程 中 执行 。 它 保证 job 是 顺序 执行 的 。 


如 何 启 用 这 个 特性 ? 从 Activiti 5.9 开始 ， 排 他 任务 已 经 是 默认 配置 了 。 所 以 异步 执行 和 定时 器 事件 默认 都 是 排他 任务 。 另 
外 ， 如 果 你 想 把 job 设置 为 非 排他 ， 可 以 使 用 activiti:exclusive="false" 进行 配置 。 比如 ， 下 面 的 服务 任务 就 是 异步 但 是 非 排 
他 的 。 


<serviceTask id="service" activiti:expression="${myService.performBooking(hotel, dates)}" activiti:async="true" activit 
Ess 一 


这 是 一 个 好 方案 吗 ? 有 一 些 人 问 我 们 这 是 否 是 一 个 好 方案 。 他 们 的 结论 会 帮 你 在 并 发 和 性 能 问题 方面 节省 时 间 。 这 个 问题 上 
需要 考虑 两 件 事 情 : 





e 如 果 是 你 是 专家 并 且 知 道 自己 在 做 什么 时 (理解 “为 什么 排他 任务 "这 章 的 内 容 ) ， 也 可 以 关闭 这 个 功能 ， 否则 ， 对 于 大 
多 数 使 用 异步 执行 和 定时 器 的 用 户 来 说 ， 这 个 功能 是 没 问 题 的 。 

。 它 也 没有 性 能 问题 ， 在 高 负载 的 情况 下 性 能 是 个 问题 。 高 负载 意味 着 JObExecutor 的 所 有 工作 线程 都 一 直 在 忙 太 着 。 使 
用 排他 任务 ，Activiti 可 以 简单 的 分 布 不 同 的 负载 。 排 他 任务 意味 着 同一 个 流程 实例 的 异步 执行 会 由 相同 的 线程 顺序 执 
行 。 但 是 要 考虑 : 如 果 你 有 多 个 流程 实例 时 。 所 有 其 他 流程 实例 的 job 也 会 分 配给 其 他 线程 同步 执行 。 意味 着 虽然 
Activiti 不 会 同时 执行 一 个 流程 实例 的 排他 jobp， 但 是 还 会 同步 执行 多 个 流程 实例 的 一 步 执行 。 通过 一 个 总 体 的 预测 ， 在 
大 多 数 场景 下 ， 它 都 会 让 单独 的 实例 运行 的 更 迅速 。 而 且 ， 对 于 同一 流程 实例 中 的 job， 需要 用 到 的 数据 也 会 利用 执行 
的 集群 节点 的 缓存 。 如 果 任 务 没 有 在 同一 个 节点 执行 ， 数 据 就 必须 每 次 从 数据 库 重 新 读 取 了 
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Process Initiation Authorization 流程 起 始 授权 


默认 所 有 人 在 部 署 的 流程 定义 上 启动 一 个 新 流程 实例 。 通 过 流程 初始 化 授权 功能 定义 的 用 户 和 组 ，web 客户 端 可 以 限制 哪些 
用 户 可 以 启动 一 个 新 流程 实例 。 注意 : Activiti 引擎 不 会 校 验 授权 定义 。 这 个 功能 只 是 为 减轻 Web 客户 端 开发 者 实现 校 验 规 
则 的 难度 。 设置 方法 与 用 户 任务 用 户 分 配 类 似 。 用 户 或 组 可 以 使 用 标签 分 配 为 流程 的 默 认 启 动 者 。 下 面 是 一 个 例子 : 


<process id="potentialstarter"> 
<extensionElements> 
<activiti:potentialStarter> 
<resourceAssignmentExpression> 
<formalExpression>group2, group(group3), user(user3)</formalExpression> 
</resourceAssignmentExpression> 
</activiti:potentialstarter> 
</extensionElements> 
<startEvent id="theStart"/> 


上 面 的 XML 中 ，user(user3) 是 直接 引用 了 用 户 user3，group(group3) 是 引用 了 组 group3。 如 果 没 显示 设置 ， 默 认 认 为 是 
群 组 。 也 可 以 使 用 标签 的 属性 ， 和 。 下 面 是 一 个 例子 : 





<process id="potentialSstarter" activiti:candidatestarterUsers="user1, user2" 
activiti:candidateStarterGroups="group1"> 


可 以 同时 使 用 这 两 个 属性 。 
定义 流程 初始 化 授权 后 ， 开 发 者 可 以 使 用 如 下 方法 获得 授权 定义 。 这 些 代 码 可 以 获得 给 定 的 用 户 可 以 启动 哪些 流程 定义 : 
processDefinitions = repositoryService.createProcessDefinitionQuery().startableByUser("uUserxxx").1List()， 
也 可 以 获得 指定 流程 定义 设置 的 潜在 启动 者 对 应 的 identity link。 
identityLinks = repositoryService.getIdentityLinksForProcessDefinition("processDefinitionId"); 
下 面 例子 演示 了 如 何 获得 可 以 启动 给 定 流程 的 用 户 列表 : 
List<User> authorizedUsers = identityService().createUserQuery().potentialstarter("processDefinitionId").1ist(); 
相同 的 方式 ， 获 得 可 以 启动 给 定 流程 配置 的 群 组 : 


List<Group> authorizedGroups = identityService().createGroupQuery().potentialstarter("processDefinitionId").1ist(); 


村 
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Data objects 数据 对 象 


[试验 ] 


BPMN 提供 了 一 种 功能 ， 可 以 在 流程 定义 或 子 流程 中 定义 数据 对 象 。 根 据 BPMN 规范 ， 流 程 定义 可 以 包含 复杂 XML 结构 ， 
可 以 导入 XSD 定义 。 对 于 Activiti 来 说 ， 作 为 Activiti 首次 支持 的 数据 对 象 ， 可 以 支持 如 下 的 XSD 类 型 : 


<dataobject 


<dataobject 


<data0bject 


<dataobject 


<data0bject 


<data0bject 


id="d0bj1" 


id="d0bj2" 


id="d0bj3" 


id="d0bj4" 


id="d0bj5" 


id="d0bj6" 


name="StringTest" itemSubjectRef="xsd:string"/> 


name="BooleanTest" itemSubjectRef="xsd:boolean"/> 


name="DateTest" itemSubjectRef="xsd:datetime"/> 


name="DoubleTest" itemSubjectRef="xsd:double"/> 


name="IntegerTest" itemSubjectRef="xsd:int"/> 


name="LongTest" itemSubjectRef="xsd:long"/> 


数据 对 象 定义 会 自动 转换 为 流程 变量 ， 名 称 与 name' 属性 对 应 。 除了 数据 对 象 的 定义 之 外 ， 
为 这 个 变量 赋予 默认 值 。 下 面 的 BPMN 片段 就 是 对 应 的 例子 : 


<process id="data0bjectScope"” name="Data Object Scope" isExecutable="true"> 
<dataobject id="d0bj123" name="StringTest123" itemSubjectRef="xsd:string"> 
<extensionElements> 
<activiti:value>Testing123</activiti:value> 
</extensionElements> 
</dataobject> 


Data objects 数据 对 象 


Activiti 也 支持 使 用 扩展 元 素来 
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Chapter 9. Forms 表单 


Activiti 提供 了 一 种 方便 而 且 灵 活 的 方式 在 业务 流程 中 以 手工 方式 添加 表单 。 我 们 对 表单 的 支持 有 2 种 方式 : 通过 表单 属性 对 
内 置 表单 进行 泻 染 和 外 证 表单 进行 泻 染 。 
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Form properties 表单 属性 


业务 流程 相关 联 的 所 有 信息 要 么 是 包含 自身 的 流程 变量 ， 要 么 是 通过 流程 变量 的 引用 。Activiti 支持 存储 复杂 的 Java 对 象 作 
为 流程 变量 ， 如 Serializable (序列 化 ) 对 象 ， Jpa 实体 对 象 或 者 整个 XML 文档 作为 字符 串 。 


用 户 是 在 启动 一 个 流程 和 完成 用 户 任 务 时 ， 与 流程 进行 交互 的 。 表 单 需要 某 个 UI 技术 泻 染 之 后 示 能 够 与 用 户 进行 交互 。 为 了 
能 够 使 用 不 同 UI 技术 变 得 容易 ， 流 程 定义 包含 一 个 对 流程 变量 中 复杂 的 Java 类 型 对 象 到 一 个 properties 的 
Map<String, String> 类 型 的 转换 逻辑 。 


使 用 Activiti API 的 方法 查看 公开 的 属性 信息 。 然 后 ， 任 意 UI 技术 都 能 够 在 这 些 属 性 上 面 构建 一 个 表单 。 该 属性 专门 〈 并 且 
更 多 局 限 性 ) 为 流程 变量 提供 了 一 个 视图 。 表单 所 需要 显示 的 属性 可 以 从 下 面 例子 中 的 返回 值 FormData 中 获取 





StartFormData FormService.getStartFormData(String processDefinitionId) 
或 者 
TaskFormdata FormService.getTaskFormData(String taskId) 


在 默认 情况 下 ， 由 这 些 属性 就 像 对 流程 变量 一 样 。 如 果 任 务 表 单 属性 和 流程 变量 是 一 对 一 的 关系 ， 那 么 任务 
表单 属性 就 不 需要 进行 申明 了 ， 例 如 ， 下 面 的 申明 : 


<startEvent id="start" /> 
当 执 行 到 开始 事件 时 ， 所 有 的 流程 变量 都 是 可 用 的 ， 但 
formsService.getStartFormData(String processDefinitionId).getFormProperties() 


会 是 一 个 空 值 ， 因 为 没有 定义 具体 的 映射 。 


在 上 面 的 实例 中 ， 所 有 被 提交 的 属性 都 将 会 作为 流程 变量 被 存储 在 Activiti 使 用 的 数据 库 中 。 这 意味 着 在 一 个 表单 中 新 添加 一 
个 简单 的 input 输入 字段 ， 也 会 作为 一 个 新 的 变量 被 存储 。 


属性 来 自 于 流程 变量 ， 但 不 一 定 非 要 作为 流程 变量 存储 起 来 ， 例 如 ， 一 个 流程 变量 可 能 是 JPA 实体 如 类 Address。 在 某 种 UI 
技术 中 使 用 的 表单 属性 StreetName 可 能 会 关联 到 一 个 表达 式 #{address.street} 。 








类 似 的 ， 用 户 提交 的 表单 属性 应 该 作为 流程 变量 进行 存储 或 者 使 用 UEL 值 表达 式 将 其 作为 流程 交 量 的 一 个 巾 套 属性 进行 存 
储 ， 例 如 #faddress.street} 。 





同样 的 ， 提 交 的 表单 属性 默认 的 行为 是 作为 流程 变量 进行 存储 ， 除 非 一 个 formproperty 申明 了 其 他 的 规则 。 
类 型 转换 同样 也 可 以 应 用 于 表单 数据 和 流程 变量 之 间 处 理 的 一 部 分 。 


举例 


<userTask id="task"> 
<extensionElements> 
<activiti:formProperty id="room" /> 
<activiti:formProperty id="duration" type="long"/> 
<activiti:formproperty id="speaker" variable="SpeakerName" writable="false" /> 
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<activiti:formproperty id="street" expression='"#{faddress.street}" required="true" /> 
</extensionElements> 
</userTask> 


e 表单 属性 room 将 会 被 映射 为 String 类 型 流程 变量 room。 

e 表单 属性 duration 将 会 被 映射 为 java.lang.Long 类 型 流程 变量 duration。 

e。 表单 属性 speaker 将 会 被 映射 为 流程 变量 SpeakerName。 它 只 能 够 在 TaskFormData 对 象 中 使 用 。 如 果 属性 speaker 
提交 ， 将 会 抛 出 一 个 ActivitiException 的 异常 。 类 似 的 ， 将 其 属性 设置 为 readable='false" ,该 属性 就 会 在 FormData 进行 
排除 ， 但 是 在 提交 后 仍然 会 对 其 进行 处 理 。 

e 表单 属性 street 将 会 映射 为 Java Bean address 的 属性 street 作为 String 类 型 的 流程 变量 。 当 提交 的 表单 属性 并 没有 
提供 并 且 required="true" 时 ， 那 么 就 会 抛 出 一 个 异常 。 








表单 数据 也 可 以 作为 FormData 的 一 部 分 提供 类 型 元 数据 。 该 FormData 可 以 从 StartFormData 
FormService.getStartFormData(String processDefinitionld) 和 TaskFormdata FormService.getTaskFormData(String taskld) 


方法 的 返回 值 中 获取 。 





我 们 支持 以 下 的 几 种 表单 属性 类 


翌 


e String (org.activiti.engine.impl.form.StringFormType 

e long (org.activiti.engine.impl.form.LongFormType) 

e enum (org.activiti.engine.impl.form.EnumFormType) 

e date (org.activiti.engine.impl.form.DateFormType) 

e boolean (org.activiti.engine.impl.form.BooleanFormType) 





对 于 申明 每 一 个 表单 属性 ， 以 下 的 FormProperty 信息 可 以 通过 List formService.getStartFormData(String 
processDefinitionld).getFormProperties() 和 List formService.getTaskFormData(String taskld).getFormProperties() 获取 。 


public interface FormProperty { 

/** the key used to submit the property in {@link FormService#submitStartFormData(String, java.util.Map)} 
* or {@link FormService#submitTaskFormData(String, java.util.Map)} */ 

String getId(); 

/** the display label */ 

String getName(); 

/** one of the types defined in this interface like e.g. {@link #TYPE_STRING} */ 

FormType getType(); 

/** optional value that should be used to display in this property */ 

String getValue(); 

/** is this property read to be displayed in the form and made accessible with the methods 
* {@link FormService#getStartFormData(String)} and {@link FormService#getTaskFormData(String)}. */ 

boolean isReadable(); 

/** is this property expected when a user submits the form? */ 

boolean iswritable(); 

/** is this property a required input field */ 

boolean isRequired(); 


举例 


<startEvent id="start"> 
<extensionElements> 
<activiti:formproperty id="speaker" 
name="Speaker" 
variable="SpeakerName" 
type="string" /> 


<activiti:formproperty id="start" 
type="date" 
datepattern="dd-MMM-yyyy" /> 


<activiti:formproperty id="direction" type="enum"> 
<activiti:value id="left" name="Go Left" /> 
<activiti:value id="right" name="Go Right" /> 
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<activiti:value id="up" name="Go Up" /> 
<activiti:value id="down" name="GoO Down" /> 
</activiti:formproperty> 


</extensionElements> 
</startEvent> 


所 有 的 表单 属性 的 信息 都 是 可 以 通过 API 进行 访问 的 。 可 以 通过 formProperty.getType().getName() 获取 类 型 的 名 称 。 甚至 
可 以 通过 formProperty.getType().getinformation("datePattern") 获取 日 期 的 匹配 方式 。 通 过 
formProperty.getType().getinformation("values") 可 以 获取 到 枚 举 值 。 


Activiti 控制 台 支 持 表 单 属性 并 且 可 以 根据 表单 定义 对 表单 进行 泻 染 。 例 如 下 面 的 XML 片段 


<startEvent> 
<extensionElements> 
<activiti:formProperty id="numberOfDays" name="Number of days" value="${numberofDays}" type="long" required="true", 
<activiti:formProperty id="startDate" name="First day of holiday (dd-MM-yyy)" value="${startDate}" datePattern="dd- 
<activiti:formproperty id="vacationMotivation" name="Motivation" value="${vacationMotivation}" type="string" /> 
</extensionElements> 
</userTask> 


图 
当 使 用 Activiti 控制 台 时 ， 它 将 会 被 泻 染 成 流程 的 启动 表单 。 





Vacation request 


Version 1 人 Deployed one hour ago 


Number of days * 
First day of holiday (dd-MM-yyy)* 


Motivation 





Start process | | Cancel | 
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External form rendering 外 部 表单 的 演 染 


该 API 同样 也 人 允许 你 执行 Activiti 流程 引擎 之 外 的 方式 泻 染 你 自己 的 任务 表单 。 这 些 步骤 说 明 你 可 以 用 你 自己 的 方式 对 任务 
表单 进行 泻 染 。 





本 质 上 ， 所 有 需要 泻 染 的 表单 属性 都 是 通过 2 个 服务 方法 中 的 一 个 进行 装配 的 : StartFormData 
FormService.getStartFormData(String processDefinitionld) 和 TaskFormdata FormService.getTaskFormData(String taskld) 


表单 属性 可 以 通过 Processlnstance FormService.submitStartFormData(String processDefinitionld,Map properties) 和 void 
FormService.submitStartFormData(String taskld,Map properties)2 种 方式 进行 提交 。 





想 要 了 解 更 多 表单 属性 如 何 映射 为 流程 变量 ， 可 以 查看 第 9.1 节 “ 表 单 属 性 ” 


你 可 以 将 任何 表单 模版 资源 放 进 你 要 部 署 的 业务 文档 之 中 (如果 你 想 要 将 它们 按照 流程 的 版 本 进行 存储 ) 。 它 将 会 在 部 署 中 
作为 一 种 可 用 的 资源 。 你 可 以 使 用 String ProcessDefinition.getDeploymentld0 和 InputStream 
RepositoryService.getResourceAsStream(String deploymentld, String resourceName); 获取 部 署 上 去 的 表单 模版 。 这 样 就 可 
以 获取 你 的 表单 模版 定义 文件 ， 那 么 你 就 可 以 在 你 自己 的 应 用 中 泻 染 / 显 示 你 的 表单 。 


你 也 可 以 使 用 该 功能 获取 任务 表单 之 外 的 其 他 的 部 署 资源 用 于 其 他 的 目的 。 属性 <userTask activiti:formkey="..." 通过 API 
String FormService.getStartFormData(String processDefinitionld).getFormKey() 和 String 
FormService.getTaskFormData(String taskld).getFormKey(0) 暴 露出 来 的 。 你 可 以 使 用 这 个 存储 你 部 署 的 模版 中 的 全 名 ( 例 
如 org/activiti/example/form/mycustom-form.xml ) ,但 是 这 并 不 是 必须 的 。 例如 ， 你 可 以 在 表单 属性 中 存储 一 个 通用 的 key， 
然后 运用 一 种 算法 或 者 换 转 去 得 到 你 实际 使 用 的 模版 。 当 你 想 要 通过 不 同 Ul 技 术 泻 染 不 能 的 表 单 ， 这 可 能 更 加 方便 ， 例 如 ， 
使 用 正常 屏幕 大 小 的 web 应 用 程序 的 表单 ， 移 动手 机 小 屏幕 的 表单 和 甚至 可 能 是 IM 表单 和 email 表单 模版 。 
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Chapter 10. JPA 


你 可 以 使 用 JPA 实 体 作 为 流程 变量 ， 并 且 可 以 这 样 做 : 


e 基于 流程 变量 更 新 已 有 的 JPA 实 体 ， 它 可 以 在 用 户 任务 的 表单 中 填写 或 者 由 服务 任务 生成 。 


。 重用 已 有 的 领域 模型 不 需要 编写 显示 的 服务 获取 实体 或 者 更 新 实体 的 值 。 


。 根据 已 有 实体 的 


Chapter 10. JPA 





属性 做 出 判断 (网 关 即 分 支 聚合 ) 。 
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10.1. Requirements 要 求 


只 支持 符合 以 下 要 求 的 实体 : 





e 实体 应 该 使 用 JPA 注解 进行 配置 ， 我 们 支持 字段 和 属性 访问 两 种 方式 。 映 射 的 超级 累 类 也 能 够 被 使 用 。 


实体 中 应 该 有 一 个 使 用 erd 注解 的 主键 ， 不 支持 复合 主键 ( @EmbeddedId 和 @Idclass )。1d 字段 /属性 能 够 使 用 JPA 规范 
支持 的 任意 类 型 : 原生 态 数据 类 型 和 他 们 的 包装 类 型 (boolean 除 外 ) ， 


String ，BigInteger ，BigDecimal ， 
java.util.Date 和 java.sql.Date . 
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10.2. Configuration 配置 


为 了 能 够 使 用 JPA 的 实体 ， 引 擎 必须 有 一 个 对 EntityManagerFactory 的 引用 。 这 可 以 通过 配置 引用 或 者 提供 一 个 持久 化 单元 
名 称 。 作 为 变量 的 JPA 实体 将 会 被 自动 检测 并 进行 相应 的 处 理 


下 面 例子 中 的 配置 是 使 用 jpaPersistenceUnitName : 


<bean id="processEngineConfiguration" 
class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> 


<!-- Database configurations --> 
<property name="databaseschemaUpdate" value="true" /> 
<property name="jdbcUrl" value="jdbc:h2:mem:JpaVariableTest;DB_ CLOSE_DELAY=1000" /> 


<property name="jpaPersistenceUnitName" value="activiti-jpa-pu" /> 
<property name="jpaHandleTransaction" value="true" /> 
<property name="jpaCloseEntityManager" value="true" /> 


<!-- job executor configurations --> 
<property name="jobExecutorActivate" value="false" /> 


<!-- mail server configurations --> 
<property name="mailServerPort" value="5025" /> 
</bean> 


接 下 来 例子 中 的 配置 提供 了 一 个 我 们 自 定 义 的 EntityManagerFactory (在 这 个 例子 中 ， 使 用 了 OpenJPA 实体 管理 器 )。 注 意 该 
代码 片段 仅仅 包含 与 例子 相关 的 beans， 去 掉 了 其 他 beans。OpenJPA 实体 管理 的 完整 并 可 以 使 用 的 例子 可 以 在 activiti- 


spring-examples( /activiti-spring/src/test/java/org/activiti/spring/test/jpa/JPASpringTest .java ) 中 找到 。 





<bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean"> 
<property name="persistenceUnitManager" ref="pum"/> 
<property name="jpaVendorAdapter"> 
<bean class="org.springframework.orm.jpa.vendor .OpenJpaVendorAdapter"> 
<property name="databasePlatform" value="org.apache.openjpa.jdbc.sql.H2Dictionary" /> 
</bean> 
</property> 
</bean> 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="dataSource" ref="dataSource" /> 
<property name="transactionManager" ref="transactionManager" /> 
<property name="databaseschemaUpdate" value="true" /> 
<property name="jpaEntityManagerFactory" ref="entityManagerFactory" /> 
<property name="jpaHandleTransaction" value="true" /> 
<property name="jpaCloseEntityManager" value="true" /> 
<property name="jobExecutorActivate" value="false" /> 
</bean> 


同样 的 配置 也 可 以 在 编程 式 创建 一 个 引擎 时 完成 ， 例 如 : 


ProcessEngine processEngine = ProcessEngineConfiguration 
.CreateProcessEngineCconfigurationFromResourceDefault() 
.SetJpaPersistenceUnitName("activiti-pu") 
.buildProcessEngine(); 


配置 属性 : 











e。 jpaPersistenceUnitName: 使 用 持久 化 单元 的 名 称 ( 要 确保 该 持久 化 单元 在 类 路 径 下 是 可 用 的 ) 。 根 据 该 规范 ， 默 认 的 路 径 是 /META- 





























INF/persistence.xml)。 要 么 使 用 jpaEntityManagerFactory 或 者 jpapersistenceUnitName 。 











e jpaEntityManagerFactory: 一 个 实现 了 javax.persistence.EntityManagerFactory 的 bean 的 引用 。 它 将 被 用 来 加 载 实体 并 且 刷 
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新 更 新 。 要 么 使 用 paEntityManagerFactory 或 者 jpaPersistenceUnitName。 


e。 jpaHandleTransaction: 在 被 使 用 的 EntityManager 实例 上 ， 该 标记 表示 流程 引擎 是 否 需要 开始 和 提交 / 回 滚 事物 。 当 使 用 
Java 事 物 API (JTA) 时 ， 设 置 为 false。 
e jpaCloseEntityManager: 该 标记 表示 流程 引擎 是 否 应 该 关闭 从 EntityManagerFactory 获取 的 EntityManager 的 实例 。 当 


EntityManager 是 由 容器 管理 的 时 候 需 要 设置 为 false (例如 当 使 用 并 不 是 单一 事物 作用 域 的 扩展 持久 化 上 下 文 的 时 
候 ) 。 
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10.3. Usage 用 法 


10.3.1. 简单 例子 


使 用 JPA 变量 的 例子 可 以 在 JPAVariableTest 中 找到 。 我 们 将 会 一 步 一 步 的 解释 


JPAVariableTest.testUpdateJPAEntityValues 。 


首先 ， 我 们 需要 创建 一 个 基于 META-INF/persistence.xml 的 EntityManagerFactory 作为 我 们 的 持久 化 单元 。 它 包含 持久 化 单 


元 中 所 有 的 类 和 一 些 供应 商 特定 的 配置 。 


我 们 将 使 用 一 个 简单 的 实体 作为 测试 ， 其 中 包含 有 一 个 id 和 string 类 型 的 value 属性 ， 


前 ， 我 们 创建 一 个 实体 并 且 保存 它 。 


@Entity(name = "JPA_ENTITY_FIELD") 
public class FieldAccessJPAEntity { 


@Id 
@Column(name = "ID_") 
private Long id; 


private String value; 


public FieldAccessJPAEntity() { 
// Empty constructor needed for JPA 
中 


public Long getId() { 
return id; 


} 


public void setId(Long id) { 
this.id = id; 


public String getValue() { 
return value; 


} 


public void setVvalue(String value) { 
this.value = value; 
让 
} 


这 也 将 会 被 持久 化 。 在 允许 测试 之 


我 们 开始 一 个 新 的 流程 实例 ， 添 加 实体 作为 变量 。 与 其 它 的 变量 一 样 ， 它 们 存储 在 引擎 的 持久 存储 区 。 当 下 次 这 个 变量 被 请 


求 ， 它 会 从 基于 类 和 ld 的 存储 的 EntityManager 中 加 载 。 


Map<String, Object> variables = new HashMap<String, Object>(); 


variables.put("entityToUpdate", entityToUpdate); 


ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("UpdateJPAValuesProcess", variables); 


在 我 们 的 流程 定义 的 第 一 个 节点 包含 一 个 serviceTask 将 调用 方法 在 entityToupdate 上 setvalue ， 它 解析 为 JPA 变量 ， 我 


们 启动 流程 实例 并 将 从 相关 联 的 当前 引擎 的 上 下 文 "EntityManager 进行 加 载 。 


<serviceTask id='theTask' name='updateJPAEntityTaSsk' 


activiti:expression="${entityToUpdate.setValue('updatedValue')}" /> 


当 service-task 完成 后 ， 流 程 实例 等 在 流程 定义 中 定义 的 userTask， 这 使 我 们 能 够 检查 流程 实例 。 
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EntityManager 已 刷新 并 更 改 到 实体 已 经 被 推 到 数据 库 。 当 我 们 得 到 变量 entityToUpdate 值 时 ， 它 再 次 加 载 ， 我 们 得 到 实 
体 ， 并 将 实体 中 的 属性 value 设置 到 updatedvalue 。 


// Servicetask in process 'UpdateJPAValuesProcess' should have set value on entityToUpdate. 
Object updatedEntity = runtimeService.getVariable(processInstance.getId(), "entityToUpdate"); 
assertTrue(updatedEntity instanceof FieldAccessJPAEnNtity); 

assertEquals("updatedValue", ((FieldAccessJPAEnNtity)updatedEntity).getValue()); 


10.3.2. 查询 JPA 义理 变量 


可 以 查询 processInstances 和 Execution 包含 JPA 实体 作为 变量 值 。 注 意 只 有 在 ProcesslnstanceQuery 和 
ExecutionQuery ， variablevalueEquals(name，entity) 是 支持 JPA 实体 的 。 方法 variablevalueNotEquals ， 


variablevalueGreaterThan , variablevalueGreaterThanOrEqual ，variablevalueLessThan 和 variableValueLessThanOrEqual 不 支 


持 ， 并 且 当 一 个 JPA 实体 传递 作为 值 时 ， 会 抛 出 ActivitiException 。 


ProcessInstance result = runtimeService.createProcessInstanceQuery() 
.variableValueEquals("entityToQuery", entityToQuery).singleResult(); 


10.3.3. 高 级 例子 : 使 用 Spring bean 和 JPA 
JPASpringTest 例子 可 以 在 activiti-spring-examples 中 找到 。 它 的 使 用 场景 如 下 : 


。 存在 一 个 使 用 JPA 实体 的 Spring bean， 用 于 存储 贷款 请 求 。 
e 使 用 Activiti， 我 们 可 以 利用 那些 由 现 有 的 bean 获得 的 已 有 的 实体 ， 并 将 其 作为 变量 在 流程 中 使 用 。 流程 是 按 以 下 步 又 
进行 定义 的 : 
o 服务 任务 ， 利 用 已 有 的 LoanRequestBean 使 用 启动 流程 时 接收 的 变量 〈 比 如， 可 以 来 源 于 开始 的 表单 ) 来 创建 新 
的 LoanRequest。 使 用 activiti:resultVariable ( 它 以 一 个 变量 来 存储 表达 式 结果 ) 将 创建 出 来 的 实体 以 变量 进行 存 
储 。 
o 用 户 任务 ， 让 经 理 查看 请 求 ， 批 准 / 不 批准 ， 结 果 存 储 到 一 个 boolean 类 型 的 变量 approvedByManager 上 。 
o 服务 任务 ， 用 来 更 新 贷款 请 求实 体 以 使 该 实体 与 流程 同步 。 
o 根据 实体 属性 approved 的 值 ， 利 用 排他 分 支 来 决定 下 一 步 选择 哪 条 路 径 : 当 请 求 被 批准 时 ， 流 程 将 结束 ; 否则 ， 
会 另 有 一 个 任务 (发送 拒绝 信 ) ， 这 样 就 可 以 由 拒绝 信和 手动 地 通知 用 户 了 。 


请 注意 此 流程 不 包含 任何 表单 ， 所 以 其 只 用 于 单元 测试 





心 


Send ee 
er 







${loanRequest.approved} 










禾 


Store decision 






s{!loanRequest.approved} 


Approve 
request 


<?xml] version="1.0" encoding="UTF-8"?> 

<definitions id="taskAssigneeExample" 
xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:activiti="http://activiti.org/bpmn" 
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targetNamespace="org.activiti.examples"> 


<process id="LoanRequestProcess" name="Process creating and handling loan request"> 
<startEvent id='theSstart" /> 
<sequenceFlow id='flow1' sourceRef='thesStart' targetRef='createLoanRequest' /> 


<serviceTask id='createLoanRequest' name='Create loan request' 
activiti:expression="${loanRequestBean.newLoanRequest (customerName, amount)}" 
activiti:resultVariable="loanRequest"/> 

<sequenceFlow id='flow2' sourceRef='createLoanRequest' targetRef='approveTask' /> 


<userTask id="approveTask" name="Approve request" /> 
<sequenceFlow id='flow3' sourceRef='approveTask' targetRef='approveOrDissaprove' /> 


<serviceTask id='approveOrDissaprove' name='Store decision' 
activiti:expression="${loanRequest.setApproved(approvedByManager)}" /> 
<sequenceFlow id='flow4' sourceRef='approveOrDissaprove' targetRef='exclusiveGw' /> 


<exclusiveGateway id="exclusiveGw" name="Exclusive Gateway approval" /> 
<sequenceFlow id="endFlowi1" sourceRef="exclusiveGw" targetRef="theEnd"> 
<conditionExpression xsi:type="tFormalExpression">${loanRequest.approved}</conditionExpression> 
</sequenceFlow> 
<sequenceFlow id="endFlow2" sourceRef="exclusiveGw" targetRef="sendRejectionLetter"> 
<conditionExpression xsi:type="tFormalExpression">${!loanRequest.approved}</conditionExpression> 
</sequenceFlow> 





<userTask id="sendRejectionLetter" name="Send rejection letter" /> 
<sequenceFlow id='flow5' sourceRef='sendRejectionLetter' targetRef= 'theotherEnd' /> 


<endEvent id='theEnd' /> 
<endEvent id='theotherEnd' /> 


</process> 


</definitions> 


虽然 上 面 的 例子 很 简单 ， 但 确实 展示 出 了 结合 Spring 和 参数 化 方法 表达 式 来 使 用 JPA 的 强大 。 此 流程 根本 不 需要 定制 java 


代码 (当然 了 ， 除 Spring bean 外 ) ， 大 大 加 速 了 部 署 











py 
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Activiti Designer BPMN features 关于 BPMN 的 特性 184 
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